Pascal (Lazarus/Delphi)

Update a Google Contact

See more Google APIs Examples

Demonstrates how to update a Google Contact. Pascal (Lazarus/Delphi)

program ChilkatDemo;

// Demonstrates using the Chilkat Pascal wrapper via the C bridge DLL.
// Builds as a console application under Lazarus (FPC) or Delphi.

{$IFDEF FPC}
  {$MODE DELPHI}
{$ENDIF}
{$APPTYPE CONSOLE}

uses
  {$IFDEF UNIX}
  cthreads,
  {$ENDIF}
  SysUtils,
  CkDllLoader,
  Chilkat.StringBuilder,
  Chilkat.AuthGoogle,
  Chilkat.Xml,
  Chilkat.JsonObject,
  Chilkat.Rest;

// ---------------------------------------------------------------------------

procedure RunDemo;
var
  success: Boolean;
  jsonToken: TJsonObject;
  gAuth: TAuthGoogle;
  rest: TRest;
  bAutoReconnect: Boolean;
  sbPath: TStringBuilder;
  numReplacements: Integer;
  sbResponseBody: TStringBuilder;
  xml: TXml;
  lastKnownEtag: string;
  sbRequestBody: TStringBuilder;

begin
  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

  jsonToken := TJsonObject.Create;
  success := jsonToken.LoadFile('qa_data/tokens/googleContacts.json');
  if (success <> True) then
    begin
      WriteLn('Failed to load googleContacts.json');
      Exit;
    end;

  gAuth := TAuthGoogle.Create;
  gAuth.AccessToken := jsonToken.StringOf('access_token');

  rest := TRest.Create;

  //  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 update a contact, we'll first get the contact information,
  //  then we'll make changes to the XML and then PUT the update.

  //  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 := TStringBuilder.Create;
  sbPath.Append('/m8/feeds/contacts/default/full/{contactId}');
  //  Get the contact having contactId = "5b6d64980b1ed462"
  numReplacements := sbPath.Replace('{contactId}','5b6d64980b1ed462');

  sbResponseBody := TStringBuilder.Create;
  success := rest.FullRequestNoBodySb('GET',sbPath.GetAsString(),sbResponseBody);
  if (success <> True) then
    begin
      WriteLn(rest.LastErrorText);
      Exit;
    end;

  //  A successful response will have a status code equal to 200.
  if (rest.ResponseStatusCode <> 200) then
    begin
      WriteLn('response status code = ' + rest.ResponseStatusCode);
      WriteLn('response status text = ' + rest.ResponseStatusText);
      WriteLn('response header: ' + rest.ResponseHeader);
      WriteLn('response body: ' + sbResponseBody.GetAsString());
      Exit;
    end;

  //  If the 200 response was received, then the contacts XML is contained
  //  in the response body.
  xml := TXml.Create;
  xml.LoadSb(sbResponseBody,False);

  //  Get the etag:
  lastKnownEtag := xml.GetAttrValue('gd:etag');
  WriteLn('lastKnownEtag = ' + lastKnownEtag);

  //  Update the XML.
  //  We're going to add or update with the following information:

  //  	  <gd:name>
  //  	    <gd:givenName>Joe</gd:givenName>
  //  	    <gd:familyName>Sample</gd:familyName>
  //  	    <gd:fullName>Joe Sample</gd:fullName>
  //  	  </gd:name>
  //  	  <content type="text">RIP Joe Sample, a great musician...</content>
  //  	  <gd:extendedProperty name="pet" value="hamster"/>

  xml.UpdateChildContent('gd:name|gd:givenName','Joe');
  xml.UpdateChildContent('gd:name|gd:familyName','Sample');
  xml.UpdateChildContent('gd:name|gd:fullName','Joe Sample');
  xml.UpdateChildContent('content','RIP Joe Sample, a great musician...');
  xml.UpdateAttrAt('content',True,'type','text');
  xml.UpdateAttrAt('gd:extendedProperty',True,'name','pet');
  xml.UpdateAttrAt('gd:extendedProperty',True,'value','hamster');

  //  Send the following:

  //  	PUT /m8/feeds/contacts/default/full/{contactId}
  //  	If-Match: {lastKnownEtag}
  //  	GData-Version: 3.0
  //  	Content-Type: application/atom+xml

  rest.ClearAllHeaders();
  rest.AddHeader('If-Match',lastKnownEtag);
  rest.AddHeader('GData-Version','3.0');
  rest.AddHeader('Content-Type','application/atom+xml');

  sbRequestBody := TStringBuilder.Create;
  xml.GetXmlSb(sbRequestBody);

  //  The sbPath already contains the correct path..
  success := rest.FullRequestSb('PUT',sbPath.GetAsString(),sbRequestBody,sbResponseBody);
  if (success <> True) then
    begin
      WriteLn(rest.LastErrorText);
      Exit;
    end;

  //  A successful response will have a status code equal to 200.
  if (rest.ResponseStatusCode <> 200) then
    begin
      WriteLn('response status code = ' + rest.ResponseStatusCode);
      WriteLn('response status text = ' + rest.ResponseStatusText);
      WriteLn('response header: ' + rest.ResponseHeader);
      WriteLn('response body: ' + sbResponseBody.GetAsString());
      Exit;
    end;

  //  If the 200 response was received, then the updated contact XML is contained
  //  in the response body.
  xml.LoadSb(sbResponseBody,False);

  WriteLn('Response Body:');
  WriteLn(xml.GetXml());
  WriteLn('Success.');


  jsonToken.Free;
  gAuth.Free;
  rest.Free;
  sbPath.Free;
  sbResponseBody.Free;
  xml.Free;
  sbRequestBody.Free;

end;

// ---------------------------------------------------------------------------

begin

  try
    RunDemo;
  except
    on E: Exception do
      WriteLn('Unhandled exception: ', E.ClassName, ': ', E.Message);
  end;

  WriteLn;
  {$IFDEF MSWINDOWS}
  WriteLn('Press Enter to exit...');
  ReadLn;
  {$ENDIF}
end.