(JavaScript) Google People API - Create Contact

Create a new contact.

For more information, see https://developers.google.com/people/v1/contacts#create-a-new-contact

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 assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

// It is assumed we previously obtained an OAuth2 access token.
// This example loads the JSON access token file 

// originally obtained by this example: Get Google People API OAuth2 Access Token
// or refreshed by this example: Refresh Google People API OAuth2 Access Token

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

var http = new CkHttp();

http.AuthToken = jsonToken.StringOf("access_token");

// Implements the following CURL command:

// curl -H "Content-Type: application/json" -X POST
//  -d '{
//  "names": [{ "givenName": "John", "familyName": "Doe" }]
//  }'
//  https://people.googleapis.com/v1/people:createContact

// Use the following online tool to generate HTTP code from a CURL command
// Convert a cURL Command to HTTP Source Code

// Use this online tool to generate code from sample JSON:
// Generate Code to Create JSON

// The following JSON is sent in the request body.

// {
//   "names": [
//     {
//       "givenName": "John",
//       "familyName": "Doe"
//     }
//   ]
// }

var json = new CkJsonObject();
json.UpdateString("names[0].givenName","John");
json.UpdateString("names[0].familyName","Doe");

var resp = new CkHttpResponse();
success = http.HttpJson("POST","https://people.googleapis.com/v1/people:createContact",json,"application/json",resp);
if (success == false) {
    console.log(http.LastErrorText);
    return;
}

var sbResponseBody = new CkStringBuilder();
resp.GetBodySb(sbResponseBody);
var jResp = new CkJsonObject();
jResp.LoadSb(sbResponseBody);
jResp.EmitCompact = false;

console.log("Response Body:");
console.log(jResp.Emit());

var respStatusCode = resp.StatusCode;
console.log("Response Status Code = " + respStatusCode);
if (respStatusCode >= 400) {
    console.log("Response Header:");
    console.log(resp.Header);
    console.log("Failed.");
    return;
}

// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)

// {
//   "resourceName": "people/c172365763025317520",
//   "etag": "%EigBAj0DBAUGBwgJPgoLPwwNDg8QQBESExQVFhc1GTQ3HyEiIyQlJicuGgQBAgUHIgxleVowR3U1SFZhcz0=",
//   "metadata": {
//     "sources": [
//       {
//         "type": "CONTACT",
//         "id": "2645dbf8c902e90",
//         "etag": "#eyZ0Gu5HVas=",
//         "updateTime": "2020-08-03T22:46:03.410Z"
//       }
//     ],
//     "objectType": "PERSON"
//   },
//   "names": [
//     {
//       "metadata": {
//         "primary": true,
//         "source": {
//           "type": "CONTACT",
//           "id": "2645dbf8c902e90"
//         }
//       },
//       "displayName": "John Doe",
//       "familyName": "Doe",
//       "givenName": "John",
//       "displayNameLastFirst": "Doe, John",
//       "unstructuredName": "John Doe"
//     }
//   ],
//   "photos": [
//     {
//       "metadata": {
//         "primary": true,
//         "source": {
//           "type": "CONTACT",
//           "id": "2645dbf8c902e90"
//         }
//       },
//       "url": "https://lh3.googleusercontent.com/-XdUIqdMkCWA/AAAAAAAAAAI/AAAAAAAAAAA/V8BNOaftJmYG2hHugNzYued7G9QFdbZOACLcDEAEiGQoBShD___________8BGNuwiP7______wE/s100/photo.jpg",
//       "default": true
//     }
//   ],
//   "memberships": [
//     {
//       "metadata": {
//         "source": {
//           "type": "CONTACT",
//           "id": "2645dbf8c902e90"
//         }
//       },
//       "contactGroupMembership": {
//         "contactGroupId": "myContacts",
//         "contactGroupResourceName": "contactGroups/myContacts"
//       }
//     }
//   ]
// }

// Sample code for parsing the JSON response...
// Use the following online tool to generate parsing code from sample JSON:
// Generate Parsing Code from JSON

var v_type;
var id;
var updateTime;
var metadataPrimary;
var metadataSourceType;
var metadataSourceId;
var displayName;
var familyName;
var givenName;
var displayNameLastFirst;
var unstructuredName;
var url;
var default;
var contactGroupMembershipContactGroupId;
var contactGroupMembershipContactGroupResourceName;

var resourceName = jResp.StringOf("resourceName");
var etag = jResp.StringOf("etag");
var metadataObjectType = jResp.StringOf("metadata.objectType");
var i = 0;
var count_i = jResp.SizeOfArray("metadata.sources");
while (i < count_i) {
    jResp.I = i;
    v_type = jResp.StringOf("metadata.sources[i].type");
    id = jResp.StringOf("metadata.sources[i].id");
    etag = jResp.StringOf("metadata.sources[i].etag");
    updateTime = jResp.StringOf("metadata.sources[i].updateTime");
    i = i+1;
}

i = 0;
count_i = jResp.SizeOfArray("names");
while (i < count_i) {
    jResp.I = i;
    metadataPrimary = jResp.BoolOf("names[i].metadata.primary");
    metadataSourceType = jResp.StringOf("names[i].metadata.source.type");
    metadataSourceId = jResp.StringOf("names[i].metadata.source.id");
    displayName = jResp.StringOf("names[i].displayName");
    familyName = jResp.StringOf("names[i].familyName");
    givenName = jResp.StringOf("names[i].givenName");
    displayNameLastFirst = jResp.StringOf("names[i].displayNameLastFirst");
    unstructuredName = jResp.StringOf("names[i].unstructuredName");
    i = i+1;
}

i = 0;
count_i = jResp.SizeOfArray("photos");
while (i < count_i) {
    jResp.I = i;
    metadataPrimary = jResp.BoolOf("photos[i].metadata.primary");
    metadataSourceType = jResp.StringOf("photos[i].metadata.source.type");
    metadataSourceId = jResp.StringOf("photos[i].metadata.source.id");
    url = jResp.StringOf("photos[i].url");
    default = jResp.BoolOf("photos[i].default");
    i = i+1;
}

i = 0;
count_i = jResp.SizeOfArray("memberships");
while (i < count_i) {
    jResp.I = i;
    metadataSourceType = jResp.StringOf("memberships[i].metadata.source.type");
    metadataSourceId = jResp.StringOf("memberships[i].metadata.source.id");
    contactGroupMembershipContactGroupId = jResp.StringOf("memberships[i].contactGroupMembership.contactGroupId");
    contactGroupMembershipContactGroupResourceName = jResp.StringOf("memberships[i].contactGroupMembership.contactGroupResourceName");
    i = i+1;
}