(PHP ActiveX) Update a Google Contact

Demonstrates how to update a Google Contact.

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows Note: The php_com_dotnet.dll may need to be enabled inside of php.ini.

<?php

// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

// --------------------------------------------------------------------------------------------------------
// Note: The code for setting up the Chilkat REST object and making the initial connection can be done once.
// Once connected, the REST object may be re-used for many REST API calls.
// (It's a good idea to put the connection setup code in a separate function/subroutine.)
// --------------------------------------------------------------------------------------------------------

// It is assumed we previously obtained an OAuth2 access token.
// This example loads the JSON access token file 
// saved by this example: Get Google Contacts OAuth2 Access Token

// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.JsonObject')
$jsonToken = new COM("Chilkat.JsonObject");
$success = $jsonToken->LoadFile('qa_data/tokens/googleContacts.json');
if ($success != 1) {
    print 'Failed to load googleContacts.json' . "\n";
    exit;
}

// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.AuthGoogle')
$gAuth = new COM("Chilkat.AuthGoogle");
$gAuth->AccessToken = $jsonToken->stringOf('access_token');

// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.Rest')
$rest = new COM("Chilkat.Rest");

// Connect using TLS.
$bAutoReconnect = 1;
$success = $rest->Connect('www.google.com',443,1,$bAutoReconnect);

// Provide the authentication credentials (i.e. the access token)
$rest->SetAuthGoogle($gAuth);

// ----------------------------------------------
// OK, the REST connection setup is completed..
// ----------------------------------------------

// To update a contact, we'll first get the contact information,
// then we'll make changes to the XML and then PUT the update.

// To retrieve the contact, send the following:
// 	GET /m8/feeds/contacts/default/full/{contactId}
// 	GData-Version: 3.0

$rest->AddHeader('GData-Version','3.0');

// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.StringBuilder')
$sbPath = new COM("Chilkat.StringBuilder");
$sbPath->Append('/m8/feeds/contacts/default/full/{contactId}');
// Get the contact having contactId = "5b6d64980b1ed462"
$numReplacements = $sbPath->Replace('{contactId}','5b6d64980b1ed462');

// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.StringBuilder')
$sbResponseBody = new COM("Chilkat.StringBuilder");
$success = $rest->FullRequestNoBodySb('GET',$sbPath->getAsString(),$sbResponseBody);
if ($success != 1) {
    print $rest->LastErrorText . "\n";
    exit;
}

// A successful response will have a status code equal to 200.
if ($rest->ResponseStatusCode != 200) {
    print 'response status code = ' . $rest->ResponseStatusCode . "\n";
    print 'response status text = ' . $rest->ResponseStatusText . "\n";
    print 'response header: ' . $rest->ResponseHeader . "\n";
    print 'response body: ' . $sbResponseBody->getAsString() . "\n";
    exit;
}

// If the 200 response was received, then the contacts XML is contained
// in the response body.
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.Xml')
$xml = new COM("Chilkat.Xml");
$xml->LoadSb($sbResponseBody,0);

// Get the etag:
$lastKnownEtag = $xml->getAttrValue('gd:etag');
print 'lastKnownEtag = ' . $lastKnownEtag . "\n";

// Update the XML.
// We're going to add or update with the following information:

// 	  <gd:name>
// 	    <gd:givenName>Joe</gd:givenName>
// 	    <gd:familyName>Sample</gd:familyName>
// 	    <gd:fullName>Joe Sample</gd:fullName>
// 	  </gd:name>
// 	  <content type="text">RIP Joe Sample, a great musician...</content>
// 	  <gd:extendedProperty name="pet" value="hamster"/>

$xml->UpdateChildContent('gd:name|gd:givenName','Joe');
$xml->UpdateChildContent('gd:name|gd:familyName','Sample');
$xml->UpdateChildContent('gd:name|gd:fullName','Joe Sample');
$xml->UpdateChildContent('content','RIP Joe Sample, a great musician...');
$xml->UpdateAttrAt('content',1,'type','text');
$xml->UpdateAttrAt('gd:extendedProperty',1,'name','pet');
$xml->UpdateAttrAt('gd:extendedProperty',1,'value','hamster');

// Send the following:

// 	PUT /m8/feeds/contacts/default/full/{contactId}
// 	If-Match: {lastKnownEtag}
// 	GData-Version: 3.0
// 	Content-Type: application/atom+xml

$rest->ClearAllHeaders();
$rest->AddHeader('If-Match',$lastKnownEtag);
$rest->AddHeader('GData-Version','3.0');
$rest->AddHeader('Content-Type','application/atom+xml');

// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.StringBuilder')
$sbRequestBody = new COM("Chilkat.StringBuilder");
$xml->GetXmlSb($sbRequestBody);

// The sbPath already contains the correct path..
$success = $rest->FullRequestSb('PUT',$sbPath->getAsString(),$sbRequestBody,$sbResponseBody);
if ($success != 1) {
    print $rest->LastErrorText . "\n";
    exit;
}

// A successful response will have a status code equal to 200.
if ($rest->ResponseStatusCode != 200) {
    print 'response status code = ' . $rest->ResponseStatusCode . "\n";
    print 'response status text = ' . $rest->ResponseStatusText . "\n";
    print 'response header: ' . $rest->ResponseHeader . "\n";
    print 'response body: ' . $sbResponseBody->getAsString() . "\n";
    exit;
}

// If the 200 response was received, then the updated contact XML is contained
// in the response body.
$xml->LoadSb($sbResponseBody,0);

print 'Response Body:' . "\n";
print $xml->getXml() . "\n";
print 'Success.' . "\n";

?>