Xbase++

Update a Google Contact

See more Google APIs Examples

Demonstrates how to update a Google Contact. Xbase++

LOCAL nSuccess
LOCAL oJsonToken
LOCAL oGAuth
LOCAL oRest
LOCAL nBAutoReconnect
LOCAL oSbPath
LOCAL nNumReplacements
LOCAL oSbResponseBody
LOCAL oXml
LOCAL cLastKnownEtag
LOCAL oSbRequestBody

nSuccess := 0

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

oJsonToken := CreateObject("Chilkat.JsonObject")
nSuccess := oJsonToken:LoadFile("qa_data/tokens/googleContacts.json")
IF (nSuccess != 1)
    ? "Failed to load googleContacts.json"
    oJsonToken:destroy()
    RETURN
ENDIF

oGAuth := CreateObject("Chilkat.AuthGoogle")
oGAuth:AccessToken := oJsonToken:StringOf("access_token")

oRest := CreateObject("Chilkat.Rest")

//  Connect using TLS.
nBAutoReconnect := 1
nSuccess := oRest:Connect("www.google.com", 443, 1, nBAutoReconnect)

//  Provide the authentication credentials (i.e. the access token)
oRest:SetAuthGoogle(oGAuth)

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

oRest:AddHeader("GData-Version", "3.0")

oSbPath := CreateObject("Chilkat.StringBuilder")
oSbPath:Append("/m8/feeds/contacts/default/full/{contactId}")
//  Get the contact having contactId = "5b6d64980b1ed462"
nNumReplacements := oSbPath:Replace("{contactId}", "5b6d64980b1ed462")

oSbResponseBody := CreateObject("Chilkat.StringBuilder")
nSuccess := oRest:FullRequestNoBodySb("GET", oSbPath:GetAsString(), oSbResponseBody)
IF (nSuccess != 1)
    ? oRest:LastErrorText
    oJsonToken:destroy()
    oGAuth:destroy()
    oRest:destroy()
    oSbPath:destroy()
    oSbResponseBody:destroy()
    RETURN
ENDIF

//  A successful response will have a status code equal to 200.
IF (oRest:ResponseStatusCode != 200)
    ? "response status code = " + Str(oRest:ResponseStatusCode)
    ? "response status text = " + oRest:ResponseStatusText
    ? "response header: " + oRest:ResponseHeader
    ? "response body: " + oSbResponseBody:GetAsString()
    oJsonToken:destroy()
    oGAuth:destroy()
    oRest:destroy()
    oSbPath:destroy()
    oSbResponseBody:destroy()
    RETURN
ENDIF

//  If the 200 response was received, then the contacts XML is contained
//  in the response body.
oXml := CreateObject("Chilkat.Xml")
oXml:LoadSb(oSbResponseBody, 0)

//  Get the etag:
cLastKnownEtag := oXml:GetAttrValue("gd:etag")
? "lastKnownEtag = " + cLastKnownEtag

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

oXml:UpdateChildContent("gd:name|gd:givenName", "Joe")
oXml:UpdateChildContent("gd:name|gd:familyName", "Sample")
oXml:UpdateChildContent("gd:name|gd:fullName", "Joe Sample")
oXml:UpdateChildContent("content", "RIP Joe Sample, a great musician...")
oXml:UpdateAttrAt("content", 1, "type", "text")
oXml:UpdateAttrAt("gd:extendedProperty", 1, "name", "pet")
oXml: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

oRest:ClearAllHeaders()
oRest:AddHeader("If-Match", cLastKnownEtag)
oRest:AddHeader("GData-Version", "3.0")
oRest:AddHeader("Content-Type", "application/atom+xml")

oSbRequestBody := CreateObject("Chilkat.StringBuilder")
oXml:GetXmlSb(oSbRequestBody)

//  The sbPath already contains the correct path..
nSuccess := oRest:FullRequestSb("PUT", oSbPath:GetAsString(), oSbRequestBody, oSbResponseBody)
IF (nSuccess != 1)
    ? oRest:LastErrorText
    oJsonToken:destroy()
    oGAuth:destroy()
    oRest:destroy()
    oSbPath:destroy()
    oSbResponseBody:destroy()
    oXml:destroy()
    oSbRequestBody:destroy()
    RETURN
ENDIF

//  A successful response will have a status code equal to 200.
IF (oRest:ResponseStatusCode != 200)
    ? "response status code = " + Str(oRest:ResponseStatusCode)
    ? "response status text = " + oRest:ResponseStatusText
    ? "response header: " + oRest:ResponseHeader
    ? "response body: " + oSbResponseBody:GetAsString()
    oJsonToken:destroy()
    oGAuth:destroy()
    oRest:destroy()
    oSbPath:destroy()
    oSbResponseBody:destroy()
    oXml:destroy()
    oSbRequestBody:destroy()
    RETURN
ENDIF

//  If the 200 response was received, then the updated contact XML is contained
//  in the response body.
oXml:LoadSb(oSbResponseBody, 0)

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

oJsonToken:destroy()
oGAuth:destroy()
oRest:destroy()
oSbPath:destroy()
oSbResponseBody:destroy()
oXml:destroy()
oSbRequestBody:destroy()