(Delphi ActiveX) Google People API - Create Contact

Create a new contact.

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

Chilkat for Delphi Downloads Chilkat ActiveX DLL for Delphi Chilkat non-ActiveX DLL for Delphi * The examples here use the ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Chilkat_TLB;

...

procedure TForm1.Button1Click(Sender: TObject);
var
jsonToken: TChilkatJsonObject;
success: Integer;
http: TChilkatHttp;
json: TChilkatJsonObject;
resp: IChilkatHttpResponse;
sbResponseBody: TChilkatStringBuilder;
jResp: TChilkatJsonObject;
respStatusCode: Integer;
v_type: WideString;
id: WideString;
updateTime: WideString;
metadataPrimary: Integer;
metadataSourceType: WideString;
metadataSourceId: WideString;
displayName: WideString;
familyName: WideString;
givenName: WideString;
displayNameLastFirst: WideString;
unstructuredName: WideString;
url: WideString;
default: Integer;
contactGroupMembershipContactGroupId: WideString;
contactGroupMembershipContactGroupResourceName: WideString;
resourceName: WideString;
etag: WideString;
metadataObjectType: WideString;
i: Integer;
count_i: Integer;

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

jsonToken := TChilkatJsonObject.Create(Self);
success := jsonToken.LoadFile('qa_data/tokens/googlePeople.json');
if (success <> 1) then
  begin
    Memo1.Lines.Add('Failed to load googleContacts.json');
    Exit;
  end;

http := TChilkatHttp.Create(Self);

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"
//     }
//   ]
// }

json := TChilkatJsonObject.Create(Self);
json.UpdateString('names[0].givenName','John');
json.UpdateString('names[0].familyName','Doe');

resp := http.PostJson3('https://people.googleapis.com/v1/people:createContact','application/json',json.ControlInterface);
if (http.LastMethodSuccess = 0) then
  begin
    Memo1.Lines.Add(http.LastErrorText);
    Exit;
  end;

sbResponseBody := TChilkatStringBuilder.Create(Self);
resp.GetBodySb(sbResponseBody.ControlInterface);
jResp := TChilkatJsonObject.Create(Self);
jResp.LoadSb(sbResponseBody.ControlInterface);
jResp.EmitCompact := 0;

Memo1.Lines.Add('Response Body:');
Memo1.Lines.Add(jResp.Emit());

respStatusCode := resp.StatusCode;
Memo1.Lines.Add('Response Status Code = ' + IntToStr(respStatusCode));
if (respStatusCode >= 400) then
  begin
    Memo1.Lines.Add('Response Header:');
    Memo1.Lines.Add(resp.Header);
    Memo1.Lines.Add('Failed.');

    Exit;
  end;

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

resourceName := jResp.StringOf('resourceName');
etag := jResp.StringOf('etag');
metadataObjectType := jResp.StringOf('metadata.objectType');
i := 0;
count_i := jResp.SizeOfArray('metadata.sources');
while i < count_i do
  begin
    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;
  end;

i := 0;
count_i := jResp.SizeOfArray('names');
while i < count_i do
  begin
    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;
  end;

i := 0;
count_i := jResp.SizeOfArray('photos');
while i < count_i do
  begin
    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;
  end;

i := 0;
count_i := jResp.SizeOfArray('memberships');
while i < count_i do
  begin
    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;
  end;
end;