(Chilkat2-Python) Retrieve a Single Contact

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

Chilkat2 Python Downloads install with pip pip3 install chilkat2 or download... Python Module for Windows, Linux, Alpine Linux, MacOS, Solaris

import sys
import chilkat2

# 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

jsonToken = chilkat2.JsonObject()
success = jsonToken.LoadFile("qa_data/tokens/googleContacts.json")
if (success != True):
    print("Failed to load googleContacts.json")
    sys.exit()

gAuth = chilkat2.AuthGoogle()
gAuth.AccessToken = jsonToken.StringOf("access_token")

rest = chilkat2.Rest()

# Connect using TLS.
bAutoReconnect = True
success = rest.Connect("www.google.com",443,True,bAutoReconnect)

# Provide the authentication credentials (i.e. the access token)
rest.SetAuthGoogle(gAuth)

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

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

sbPath = chilkat2.StringBuilder()
sbPath.Append("/m8/feeds/contacts/default/full/{contactId}")
# Get the contact having contactId = "7b1c7b6409e718a0"
numReplacements = sbPath.Replace("{contactId}","7b1c7b6409e718a0")

sbResponseBody = chilkat2.StringBuilder()
success = rest.FullRequestNoBodySb("GET",sbPath.GetAsString(),sbResponseBody)
if (success != True):
    print(rest.LastErrorText)
    sys.exit()

# A successful response will have a status code equal to 200.
if (rest.ResponseStatusCode != 200):
    print("response status code = " + str(rest.ResponseStatusCode))
    print("response status text = " + rest.ResponseStatusText)
    print("response header: " + rest.ResponseHeader)
    print("response body: " + sbResponseBody.GetAsString())
    sys.exit()

# If the 200 response was received, then the contacts XML is contained
# in the response body.
xml = chilkat2.Xml()
xml.LoadSb(sbResponseBody,False)

# See below for a sample response body.
xml.SaveXml("qa_output/google_contact.xml")

# Now let's parse the XML...
print("title: " + xml.GetChildContent("title"))

emailAddress = xml.ChilkatPath("gd:email|(address)")
if (xml.LastMethodSuccess == True):
    print("email address: " + emailAddress)

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