Dart

Update a Google Contact

See more Google APIs Examples

Demonstrates how to update a Google Contact. Dart

import 'package:chilkat/chilkat.dart';

void main() {
  // 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

  final jsonToken = CkJsonObject();
  try {
    jsonToken.loadFile('qa_data/tokens/googleContacts.json');
  } on ChilkatException {
    print('Failed to load googleContacts.json');
    return;
  }

  final gAuth = CkAuthGoogle();
  gAuth.accessToken = jsonToken.stringOf('access_token');

  final rest = CkRest();

  // Connect using TLS.
  final bAutoReconnect = true;
  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');

  final sbPath = CkStringBuilder();
  sbPath.append('/m8/feeds/contacts/default/full/{contactId}');
  // Get the contact having contactId = "5b6d64980b1ed462"
  final numReplacements = sbPath.replace('{contactId}', '5b6d64980b1ed462');

  final sbResponseBody = CkStringBuilder();
  try {
    rest.fullRequestNoBodySb('GET', sbPath.getAsString(), sbResponseBody);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // A successful response will have a status code equal to 200.
  if (rest.responseStatusCode != 200) {
    print('response status code = ${rest.responseStatusCode}');
    print('response status text = ${rest.responseStatusText}');
    print('response header: ${rest.responseHeader}');
    print('response body: ${sbResponseBody.getAsString()}');
    return;
  }

  // If the 200 response was received, then the contacts XML is contained
  // in the response body.
  final xml = CkXml();
  xml.loadSb(sbResponseBody, false);

  // Get the etag:
  final lastKnownEtag = xml.getAttrValue('gd:etag');
  print('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');

  final sbRequestBody = CkStringBuilder();
  xml.getXmlSb(sbRequestBody);

  // The sbPath already contains the correct path..
  try {
    rest.fullRequestSb('PUT', sbPath.getAsString(), sbRequestBody, sbResponseBody);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // A successful response will have a status code equal to 200.
  if (rest.responseStatusCode != 200) {
    print('response status code = ${rest.responseStatusCode}');
    print('response status text = ${rest.responseStatusText}');
    print('response header: ${rest.responseHeader}');
    print('response body: ${sbResponseBody.getAsString()}');
    return;
  }

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

  print('Response Body:');
  print(xml.getXml());
  print('Success.');
}