(Lianja) Update a Google Contact

Demonstrates how to update a Google Contact.

Chilkat Lianja Extension Download Chilkat Lianja Extension

// 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

loJsonToken = createobject("CkJsonObject")
llSuccess = loJsonToken.LoadFile("qa_data/tokens/googleContacts.json")
if (llSuccess <> .T.) then
    ? "Failed to load googleContacts.json"
    release loJsonToken
    return
endif

loGAuth = createobject("CkAuthGoogle")
loGAuth.AccessToken = loJsonToken.StringOf("access_token")

loRest = createobject("CkRest")

// Connect using TLS.
llBAutoReconnect = .T.
llSuccess = loRest.Connect("www.google.com",443,.T.,llBAutoReconnect)

// Provide the authentication credentials (i.e. the access token)
loRest.SetAuthGoogle(loGAuth)

// ----------------------------------------------
// 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

loRest.AddHeader("GData-Version","3.0")

loSbPath = createobject("CkStringBuilder")
loSbPath.Append("/m8/feeds/contacts/default/full/{contactId}")
// Get the contact having contactId = "5b6d64980b1ed462"
lnNumReplacements = loSbPath.Replace("{contactId}","5b6d64980b1ed462")

loSbResponseBody = createobject("CkStringBuilder")
llSuccess = loRest.FullRequestNoBodySb("GET",loSbPath.GetAsString(),loSbResponseBody)
if (llSuccess <> .T.) then
    ? loRest.LastErrorText
    release loJsonToken
    release loGAuth
    release loRest
    release loSbPath
    release loSbResponseBody
    return
endif

// A successful response will have a status code equal to 200.
if (loRest.ResponseStatusCode <> 200) then
    ? "response status code = " + str(loRest.ResponseStatusCode)
    ? "response status text = " + loRest.ResponseStatusText
    ? "response header: " + loRest.ResponseHeader
    ? "response body: " + loSbResponseBody.GetAsString()
    release loJsonToken
    release loGAuth
    release loRest
    release loSbPath
    release loSbResponseBody
    return
endif

// If the 200 response was received, then the contacts XML is contained
// in the response body.
loXml = createobject("CkXml")
loXml.LoadSb(loSbResponseBody,.F.)

// Get the etag:
lcLastKnownEtag = loXml.GetAttrValue("gd:etag")
? "lastKnownEtag = " + lcLastKnownEtag

// 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"/>

loXml.UpdateChildContent("gd:name|gd:givenName","Joe")
loXml.UpdateChildContent("gd:name|gd:familyName","Sample")
loXml.UpdateChildContent("gd:name|gd:fullName","Joe Sample")
loXml.UpdateChildContent("content","RIP Joe Sample, a great musician...")
loXml.UpdateAttrAt("content",.T.,"type","text")
loXml.UpdateAttrAt("gd:extendedProperty",.T.,"name","pet")
loXml.UpdateAttrAt("gd:extendedProperty",.T.,"value","hamster")

// Send the following:

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

loRest.ClearAllHeaders()
loRest.AddHeader("If-Match",lcLastKnownEtag)
loRest.AddHeader("GData-Version","3.0")
loRest.AddHeader("Content-Type","application/atom+xml")

loSbRequestBody = createobject("CkStringBuilder")
loXml.GetXmlSb(loSbRequestBody)

// The sbPath already contains the correct path..
llSuccess = loRest.FullRequestSb("PUT",loSbPath.GetAsString(),loSbRequestBody,loSbResponseBody)
if (llSuccess <> .T.) then
    ? loRest.LastErrorText
    release loJsonToken
    release loGAuth
    release loRest
    release loSbPath
    release loSbResponseBody
    release loXml
    release loSbRequestBody
    return
endif

// A successful response will have a status code equal to 200.
if (loRest.ResponseStatusCode <> 200) then
    ? "response status code = " + str(loRest.ResponseStatusCode)
    ? "response status text = " + loRest.ResponseStatusText
    ? "response header: " + loRest.ResponseHeader
    ? "response body: " + loSbResponseBody.GetAsString()
    release loJsonToken
    release loGAuth
    release loRest
    release loSbPath
    release loSbResponseBody
    release loXml
    release loSbRequestBody
    return
endif

// If the 200 response was received, then the updated contact XML is contained
// in the response body.
loXml.LoadSb(loSbResponseBody,.F.)

? "Response Body:"
? loXml.GetXml()
? "Success."


release loJsonToken
release loGAuth
release loRest
release loSbPath
release loSbResponseBody
release loXml
release loSbRequestBody