DataFlex
DataFlex
Retrieve a Single Contact
See more Google APIs Examples
Demonstrates how to retrieve a single contact (by contactId) for the Google Contacts API.Chilkat DataFlex Downloads
Use ChilkatAx-win32.pkg
Procedure Test
Boolean iSuccess
Handle hoJsonToken
Variant vGAuth
Handle hoGAuth
Handle hoRest
Boolean iBAutoReconnect
Handle hoSbPath
Integer iNumReplacements
Variant vSbResponseBody
Handle hoSbResponseBody
Handle hoXml
String sEmailAddress
String sTemp1
Integer iTemp1
Boolean bTemp1
Move False To iSuccess
// 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
Get Create (RefClass(cComChilkatJsonObject)) To hoJsonToken
If (Not(IsComObjectCreated(hoJsonToken))) Begin
Send CreateComObject of hoJsonToken
End
Get ComLoadFile Of hoJsonToken "qa_data/tokens/googleContacts.json" To iSuccess
If (iSuccess <> True) Begin
Showln "Failed to load googleContacts.json"
Procedure_Return
End
Get Create (RefClass(cComChilkatAuthGoogle)) To hoGAuth
If (Not(IsComObjectCreated(hoGAuth))) Begin
Send CreateComObject of hoGAuth
End
Get ComStringOf Of hoJsonToken "access_token" To sTemp1
Set ComAccessToken Of hoGAuth To sTemp1
Get Create (RefClass(cComChilkatRest)) To hoRest
If (Not(IsComObjectCreated(hoRest))) Begin
Send CreateComObject of hoRest
End
// Connect using TLS.
Move True To iBAutoReconnect
Get ComConnect Of hoRest "www.google.com" 443 True iBAutoReconnect To iSuccess
// Provide the authentication credentials (i.e. the access token)
Get pvComObject of hoGAuth to vGAuth
Get ComSetAuthGoogle Of hoRest vGAuth To iSuccess
// ----------------------------------------------
// OK, the REST connection setup is completed..
// ----------------------------------------------
// To retrieve the contact, send the following:
// GET /m8/feeds/contacts/default/full/{contactId}
// GData-Version: 3.0
Get ComAddHeader Of hoRest "GData-Version" "3.0" To iSuccess
Get Create (RefClass(cComChilkatStringBuilder)) To hoSbPath
If (Not(IsComObjectCreated(hoSbPath))) Begin
Send CreateComObject of hoSbPath
End
Get ComAppend Of hoSbPath "/m8/feeds/contacts/default/full/{contactId}" To iSuccess
// Get the contact having contactId = "7b1c7b6409e718a0"
Get ComReplace Of hoSbPath "{contactId}" "7b1c7b6409e718a0" To iNumReplacements
Get Create (RefClass(cComChilkatStringBuilder)) To hoSbResponseBody
If (Not(IsComObjectCreated(hoSbResponseBody))) Begin
Send CreateComObject of hoSbResponseBody
End
Get ComGetAsString Of hoSbPath To sTemp1
Get pvComObject of hoSbResponseBody to vSbResponseBody
Get ComFullRequestNoBodySb Of hoRest "GET" sTemp1 vSbResponseBody To iSuccess
If (iSuccess <> True) Begin
Get ComLastErrorText Of hoRest To sTemp1
Showln sTemp1
Procedure_Return
End
// A successful response will have a status code equal to 200.
Get ComResponseStatusCode Of hoRest To iTemp1
If (iTemp1 <> 200) Begin
Get ComResponseStatusCode Of hoRest To iTemp1
Showln "response status code = " iTemp1
Get ComResponseStatusText Of hoRest To sTemp1
Showln "response status text = " sTemp1
Get ComResponseHeader Of hoRest To sTemp1
Showln "response header: " sTemp1
Get ComGetAsString Of hoSbResponseBody To sTemp1
Showln "response body: " sTemp1
Procedure_Return
End
// If the 200 response was received, then the contacts XML is contained
// in the response body.
Get Create (RefClass(cComChilkatXml)) To hoXml
If (Not(IsComObjectCreated(hoXml))) Begin
Send CreateComObject of hoXml
End
Get pvComObject of hoSbResponseBody to vSbResponseBody
Get ComLoadSb Of hoXml vSbResponseBody False To iSuccess
// See below for a sample response body.
Get ComSaveXml Of hoXml "qa_output/google_contact.xml" To iSuccess
// Now let's parse the XML...
Get ComGetChildContent Of hoXml "title" To sTemp1
Showln "title: " sTemp1
Get ComChilkatPath Of hoXml "gd:email|(address)" To sEmailAddress
Get ComLastMethodSuccess Of hoXml To bTemp1
If (bTemp1 = True) Begin
Showln "email address: " sEmailAddress
End
// The response body XML looks something like this:
// <?xml version="1.0" encoding="UTF-8" ?>
// <entry gd:etag=""R3kzezVSLit7I2A9XRFaFE8DQAU."" xmlns="http://www.w3.org/2005/Atom" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gContact="http://schemas.google.com/contact/2008" xmlns:gd="http://schemas.google.com/g/2005">
// <id>http://www.google.com/m8/feeds/contacts/support%40chilkatcloud.com/base/7b1c7b6409e718a0</id>
// <updated>2016-11-18T00:41:56.783Z</updated>
// <app:edited xmlns:app="http://www.w3.org/2007/app">2016-11-18T00:41:56.783Z</app:edited>
// <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#contact" />
// <title>Chilkat Cloud</title>
// <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*" href="https://www.googleapis.com/m8/feeds/photos/media/support%40chilkatcloud.com/7b1c7b6409e718a0" gd:etag=""fgVhPls4Sit7I2BWHUlTWkQMKHUZKHkkaiw."" />
// <link rel="self" type="application/atom+xml" href="https://www.googleapis.com/m8/feeds/contacts/support%40chilkatcloud.com/full/7b1c7b6409e718a0" />
// <link rel="edit" type="application/atom+xml" href="https://www.googleapis.com/m8/feeds/contacts/support%40chilkatcloud.com/full/7b1c7b6409e718a0" />
// <gd:name>
// <gd:fullName>Chilkat Cloud</gd:fullName>
// <gd:givenName>Chilkat</gd:givenName>
// <gd:familyName>Cloud</gd:familyName>
// </gd:name>
// <gd:email rel="http://schemas.google.com/g/2005#other" address="support@chilkatcloud.com" primary="true" />
// <gContact:groupMembershipInfo deleted="false" href="http://www.google.com/m8/feeds/groups/support%40chilkatcloud.com/base/6" />
// </entry>
End_Procedure