(DataFlex) Retrieve a Single Contact

Demonstrates how to retrieve a single contact (by contactId) for the Google Contacts API.

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

Use ChilkatAx-win32.pkg

Procedure Test
    Handle hoJsonToken
    Boolean iSuccess
    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

    // 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="&quot;R3kzezVSLit7I2A9XRFaFE8DQAU.&quot;" 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="&quot;fgVhPls4Sit7I2BWHUlTWkQMKHUZKHkkaiw.&quot;" />
    // 	    <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