Pascal (Lazarus/Delphi)

Outlook Contacts Update (PATCH) a Contact

See more Outlook Contact Examples

Update the properties of an Outlook contact object. 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.Http,
  Chilkat.HttpResponse,
  Chilkat.JsonObject;

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

procedure RunDemo;
var
  success: Boolean;
  http: THttp;
  jsonToken: TJsonObject;
  json: TJsonObject;
  id: string;
  resp: THttpResponse;
  jResp: TJsonObject;

begin
  success := False;

  //  This example requires the Chilkat API to have been previously unlocked.
  //  See Global Unlock Sample for sample code.

  http := THttp.Create;

  //  Use your previously obtained access token here: Get Outlook Contacts OAuth2 Access Token (Azure AD v2.0 Endpoint).

  jsonToken := TJsonObject.Create;
  success := jsonToken.LoadFile('qa_data/tokens/outlookContacts.json');
  if (success = False) then
    begin
      WriteLn(jsonToken.LastErrorText);
      Exit;
    end;

  http.AuthToken := jsonToken.StringOf('access_token');

  //  Send the following PATCH:

  //  PATCH https://graph.microsoft.com/v1.0/me/contacts/{id}
  //  Content-type: application/json
  //  Content-length: 1977
  //  
  //  {
  //    "homeAddress": {
  //      "street": "123 Some street",
  //      "city": "Seattle",
  //      "state": "WA",
  //      "postalCode": "98121"
  //    },
  //    "birthday": "1974-07-22"
  //  }

  //  Build the JSON body of the POST.

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

  json := TJsonObject.Create;
  json.UpdateString('homeAddress.street','123 Some street');
  json.UpdateString('homeAddress.city','Seattle');
  json.UpdateString('homeAddress.state','WA');
  json.UpdateString('homeAddress.postalCode','98121');
  json.UpdateString('birthday','1974-07-22');

  //  We need the ID of the contact to be updated.
  //  This was available in the response when we created the contact:  Create an Outlook Contact.
  //  Or you can list contacts to get the ID: List Outlook Contacts).

  id := 'AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQBGAAAAAAAu7cUXL5YOTrdsUIw7-v8FBwBUcG0qWqkmQYqWLHQataQxAAAAAAEOAABUcG0qWqkmQYqWLHQataQxAAD0sxexAAA=';
  http.SetUrlVar('id',id);

  //  Send the HTTP PATCH
  resp := THttpResponse.Create;
  success := http.HttpJson('PATCH','https://graph.microsoft.com/v1.0/me/contacts/{$id}',json,'application/json',resp);
  if (success = False) then
    begin
      WriteLn(http.LastErrorText);
      Exit;
    end;

  WriteLn('Response status code = ' + resp.StatusCode);

  jResp := TJsonObject.Create;
  jResp.Load(resp.BodyStr);
  jResp.EmitCompact := False;
  WriteLn(jResp.Emit());

  //  The send succeeded if the response status code = 201.
  if (resp.StatusCode <> 200) then
    begin
      WriteLn('Failed');
      Exit;
    end;

  //  Sample JSON response:

  //  {
  //    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('4ee732c3-322e-4a6b-b729-2fd1eb5c6004')/contacts/$entity",
  //    "@odata.etag": "W/\"EQAAABYAAABUcG0qWqkmQYqWLHQataQxAAD0iYu5\"",
  //    "id": "AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQBGAAAAAAAu7cUXL5YOTrdsUIw7-v8FBwBUcG0qWqkmQYqWLHQataQxAAAAAAEOAABUcG0qWqkmQYqWLHQataQxAAD0sxexAAA=",
  //    "createdDateTime": "2021-06-29T16:32:05Z",
  //    "lastModifiedDateTime": "2021-06-29T16:57:39Z",
  //    "changeKey": "EQAAABYAAABUcG0qWqkmQYqWLHQataQxAAD0iYu5",
  //    "categories": [
  //    ],
  //    "parentFolderId": "AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQAuAAAAAAAu7cUXL5YOTrdsUIw7-v8FAQBUcG0qWqkmQYqWLHQataQxAAAAAAEOAAA=",
  //    "birthday": "1974-07-22T11:59:00Z",
  //    "fileAs": "",
  //    "displayName": "Pavel Bansky",
  //    "givenName": "Pavel",
  //    "initials": null,
  //    "middleName": null,
  //    "nickName": null,
  //    "surname": "Bansky",
  //    "title": null,
  //    "yomiGivenName": null,
  //    "yomiSurname": null,
  //    "yomiCompanyName": null,
  //    "generation": null,
  //    "imAddresses": [
  //    ],
  //    "jobTitle": null,
  //    "companyName": null,
  //    "department": null,
  //    "officeLocation": null,
  //    "profession": null,
  //    "businessHomePage": null,
  //    "assistantName": null,
  //    "manager": null,
  //    "homePhones": [
  //    ],
  //    "mobilePhone": null,
  //    "businessPhones": [
  //      "+1 732 555 0102"
  //    ],
  //    "spouseName": null,
  //    "personalNotes": "",
  //    "children": [
  //    ],
  //    "emailAddresses": [
  //      {
  //        "name": "Pavel Bansky",
  //        "address": "pavelb@fabrikam.onmicrosoft.com"
  //      }
  //    ],
  //    "homeAddress": {
  //      "street": "123 Some street",
  //      "city": "Seattle",
  //      "state": "WA",
  //      "postalCode": "98121"
  //    },
  //    "businessAddress": {},
  //    "otherAddress": {}
  //  }

  WriteLn('Contact updated.');


  http.Free;
  jsonToken.Free;
  json.Free;
  resp.Free;
  jResp.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.