Visual FoxPro

Find Contact Having Email Address

See more Google APIs Examples

Demonstrates how to fetch the Google Contact for a given email address. Visual FoxPro

LOCAL lnSuccess
LOCAL loJsonToken
LOCAL loGAuth
LOCAL loRest
LOCAL lnBAutoReconnect
LOCAL lcEmailAddressToFind
LOCAL loSbResponseBody
LOCAL loXml
LOCAL lnTotalResults
LOCAL lnStartIndex
LOCAL lnItemsPerPage
LOCAL loFac
LOCAL lnNumEntries
LOCAL i
LOCAL lcIdUrl
LOCAL lcContactId
LOCAL lcFullName
LOCAL lcEmailAddress

lnSuccess = 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

loJsonToken = CreateObject('Chilkat.JsonObject')
lnSuccess = loJsonToken.LoadFile("qa_data/tokens/googleContacts.json")
IF (lnSuccess <> 1) THEN
    ? "Failed to load googleContacts.json"
    RELEASE loJsonToken
    CANCEL
ENDIF

loGAuth = CreateObject('Chilkat.AuthGoogle')
loGAuth.AccessToken = loJsonToken.StringOf("access_token")

loRest = CreateObject('Chilkat.Rest')

* Connect using TLS.
lnBAutoReconnect = 1
lnSuccess = loRest.Connect("www.google.com",443,1,lnBAutoReconnect)

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

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

* To retrieve the contacts, we need to send the following:

* 	GET /m8/feeds/contacts/default/full?q=<emailAddress>
* 	GData-Version: 3.0

* Get the contact (or contacts) with this email address:
lcEmailAddressToFind = "admin@chilkatsoft.com"

loRest.AddHeader("GData-Version","3.0")
loRest.AddQueryParam("q",lcEmailAddressToFind)

loSbResponseBody = CreateObject('Chilkat.StringBuilder')
lnSuccess = loRest.FullRequestNoBodySb("GET","/m8/feeds/contacts/default/full",loSbResponseBody)
IF (lnSuccess <> 1) THEN
    ? loRest.LastErrorText
    RELEASE loJsonToken
    RELEASE loGAuth
    RELEASE loRest
    RELEASE loSbResponseBody
    CANCEL
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 loSbResponseBody
    CANCEL
ENDIF

* If the 200 response was received, then the contacts XML is contained
* in the response body.
loXml = CreateObject('Chilkat.Xml')
loXml.LoadSb(loSbResponseBody,0)

* See below for a sample response body.
loXml.SaveXml("qa_output/google_contacts.xml")

* Now let's parse the XML...

* Get the the total number of results, the start index, and the items per page.
* We'll likely NOT get the full list, but will instead get the 1st page.
lnTotalResults = loXml.GetChildIntValue("openSearch:totalResults")
lnStartIndex = loXml.GetChildIntValue("openSearch:startIndex")
lnItemsPerPage = loXml.GetChildIntValue("openSearch:itemsPerPage")
? "totalResults = " + STR(lnTotalResults)
? "startIndex = " + STR(lnStartIndex)
? "itemsPerPage = " + STR(lnItemsPerPage)

* We'll borrow a method from FileAccess to get the contactId from the URL string (see the code in the while loop)
loFac = CreateObject('Chilkat.FileAccess')

* Iterate over each contact.
lnNumEntries = loXml.NumChildrenHavingTag("entry")
i = 0
DO WHILE i < lnNumEntries
    loXml.I = i
    ? STR(i + 1) + " ----"
    ? "title: " + loXml.GetChildContent("entry[i]|title")

    * The entry "id" child contains a URL having this format:
    * <id>http://www.google.com/m8/feeds/contacts/{userEmail}/base/{contactId}</id>
    * Let's get the URL and parse the contactId from it..
    lcIdUrl = loXml.GetChildContent("entry[i]|id")
    ? "id: " + lcIdUrl

    * Use the parsing ability of GetFileName to get the contactId
    lcContactId = loFac.GetFileName(lcIdUrl)
    ? "contactId: " + lcContactId

    lcFullName = loXml.ChilkatPath("entry[i]|gd:name|gd:fullName|*")
    IF (loXml.LastMethodSuccess = 1) THEN
        ? "fullName: " + lcFullName
    ENDIF

    lcEmailAddress = loXml.ChilkatPath("entry[i]|gd:email|(address)")
    IF (loXml.LastMethodSuccess = 1) THEN
        ? "email address: " + lcEmailAddress
    ENDIF

    i = i + 1
ENDDO

RELEASE loJsonToken
RELEASE loGAuth
RELEASE loRest
RELEASE loSbResponseBody
RELEASE loXml
RELEASE loFac