(JavaScript) Download Google Contact Photo

Demonstrates how to download Google Contact's photo.

Note

This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.

var success = false;

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

var jsonToken = new CkJsonObject();
success = jsonToken.LoadFile("qa_data/tokens/googleContacts.json");
if (success !== true) {
    console.log("Failed to load googleContacts.json");
    return;
}

var gAuth = new CkAuthGoogle();
gAuth.AccessToken = jsonToken.StringOf("access_token");

var rest = new CkRest();

// Connect using TLS.
var 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 get the photo, send the following:

// 	GET /m8/feeds/photos/media/default/contactId

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

var sbPath = new CkStringBuilder();
// Get the photo for the contact having contactId = "1ea2e4fe0ef24e09"
var contactId = "1ea2e4fe0ef24e09";
sbPath.SetString("/m8/feeds/photos/media/default/{contactId}");
var numReplacements = sbPath.Replace("{contactId}",contactId);

var imageData = new CkBinData();
success = rest.FullRequestNoBodyBd("GET",sbPath.GetAsString(),imageData);
if (success !== true) {
    console.log(rest.LastErrorText);
    return;
}

// A 404 response indicates the contact has no photo.
// (We could've first fetched the contact information, parsed out the 
// photo etag, and then if no photo etag existed, we'd know the contact has no
// photo.  Or... we can just try to download the photo and if a 404 is received,
// we know there's no photo.  Much simpler.)
if (rest.ResponseStatusCode == 404) {
    console.log("This contact has no photo.");
    return;
}

// A successful response will have a status code equal to 200.
if (rest.ResponseStatusCode !== 200) {
    // If the response was not successful, then the response body
    // does not contain image data.  Instead it contains XML.
    var sbResponseBody = new CkStringBuilder();
    sbResponseBody.AppendBd(imageData,"utf-8",0,0);

    console.log("response status code = " + rest.ResponseStatusCode);
    console.log("response status text = " + rest.ResponseStatusText);
    console.log("response header: " + rest.ResponseHeader);
    console.log("response body: " + sbResponseBody.GetAsString());
    console.log("request startline: " + rest.LastRequestStartLine);
    console.log("request header: " + rest.LastRequestHeader);
    return;
}

// Examine the content-type in the response header so we know what file
// extension to use (.jpg, .png, etc.)
var sbContentType = new CkStringBuilder();
sbContentType.Append(rest.ResponseHdrByName("Content-Type"));

if (sbContentType.ContentsEqual("image/jpeg",false) == true) {
    imageData.WriteFile("qa_output/contact_photo.jpg");
}

if (sbContentType.ContentsEqual("image/png",false) == true) {
    imageData.WriteFile("qa_output/contact_photo.png");
}

console.log("Content-Type: " + sbContentType.GetAsString());
console.log("Success.");