Dart
Dart
Google Contacts - Create New Contact
See more Google APIs Examples
Demonstrates how to create a new contact for the Google Contacts API.Chilkat Dart Downloads
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.
// First create a new contact XML.
final xml = CkXml();
xml.tag = 'atom:entry';
xml.addAttribute('xmlns:atom', 'http://www.w3.org/2005/Atom');
xml.addAttribute('xmlns:gd', 'http://schemas.google.com/g/2005');
xml.updateAttrAt('atom:category', true, 'scheme', 'http://schemas.google.com/g/2005#kind');
xml.updateAttrAt('atom:category', true, 'term', 'http://schemas.google.com/contact/2008#contact');
xml.updateChildContent('gd:name|gd:givenName', 'Elizabeth');
xml.updateChildContent('gd:name|gd:familyName', 'Bennet');
xml.updateChildContent('gd:name|gd:fullName', 'Elizabeth Bennet');
xml.updateAttrAt('atom:content', true, 'type', 'text');
xml.updateChildContent('atom:content', 'Notes');
xml.updateAttrAt('gd:email', true, 'rel', 'http://schemas.google.com/g/2005#work');
xml.updateAttrAt('gd:email', true, 'primary', 'true');
xml.updateAttrAt('gd:email', true, 'address', 'liz@gmail.com');
xml.updateAttrAt('gd:email', true, 'displayName', 'E. Bennet');
xml.updateAttrAt('gd:email', true, 'rel', 'http://schemas.google.com/g/2005#home');
xml.updateAttrAt('gd:email', true, 'address', 'liz@example.org');
xml.updateAttrAt('gd:phoneNumber', true, 'rel', 'http://schemas.google.com/g/2005#work');
xml.updateAttrAt('gd:phoneNumber', true, 'primary', 'true');
xml.updateChildContent('gd:phoneNumber', '(206)555-1212');
xml.updateAttrAt('gd:phoneNumber', true, 'rel', 'http://schemas.google.com/g/2005#home');
xml.updateChildContent('gd:phoneNumber', '(206)555-1213');
xml.updateAttrAt('gd:im', true, 'address', 'liz@gmail.com');
xml.updateAttrAt('gd:im', true, 'protocol', 'http://schemas.google.com/g/2005#GOOGLE_TALK');
xml.updateAttrAt('gd:im', true, 'primary', 'true');
xml.updateAttrAt('gd:im', true, 'rel', 'http://schemas.google.com/g/2005#home');
xml.updateAttrAt('gd:structuredPostalAddress', true, 'rel', 'http://schemas.google.com/g/2005#work');
xml.updateAttrAt('gd:structuredPostalAddress', true, 'primary', 'true');
xml.updateChildContent('gd:structuredPostalAddress|gd:city', 'Mountain View');
xml.updateChildContent('gd:structuredPostalAddress|gd:street', '1600 Amphitheatre Pkwy');
xml.updateChildContent('gd:structuredPostalAddress|gd:region', 'CA');
xml.updateChildContent('gd:structuredPostalAddress|gd:postcode', '94043');
xml.updateChildContent('gd:structuredPostalAddress|gd:country', 'United States');
xml.updateChildContent('gd:structuredPostalAddress|gd:formattedAddress', '1600 Amphitheatre Pkwy Mountain View');
print(xml.getXml());
// Created the following XML:
// <?xml version="1.0" encoding="utf-8" ?>
// <atom:entry xmlns:atom="http://www.w3.org/2005/Atom" xmlns:gd="http://schemas.google.com/g/2005">
// <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#contact" />
// <gd:name>
// <gd:givenName>Elizabeth</gd:givenName>
// <gd:familyName>Bennet</gd:familyName>
// <gd:fullName>Elizabeth Bennet</gd:fullName>
// </gd:name>
// <atom:content type="text">Notes</atom:content>
// <gd:email primary="true" displayName="E. Bennet" rel="http://schemas.google.com/g/2005#home" address="liz@example.org" />
// <gd:phoneNumber primary="true" rel="http://schemas.google.com/g/2005#home">(206)555-1213</gd:phoneNumber>
// <gd:im address="liz@gmail.com" protocol="http://schemas.google.com/g/2005#GOOGLE_TALK" primary="true" rel="http://schemas.google.com/g/2005#home" />
// <gd:structuredPostalAddress rel="http://schemas.google.com/g/2005#work" primary="true">
// <gd:city>Mountain View</gd:city>
// <gd:street>1600 Amphitheatre Pkwy</gd:street>
// <gd:region>CA</gd:region>
// <gd:postcode>94043</gd:postcode>
// <gd:country>United States</gd:country>
// <gd:formattedAddress>1600 Amphitheatre Pkwy Mountain View</gd:formattedAddress>
// </gd:structuredPostalAddress>
// </atom:entry>
// --------------------------------------------------------------------------------------------------------
// 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 create a contact, we need to send the following:
// POST /m8/feeds/contacts/default/full
// Content-Type: application/atom+xml
// GData-Version: 3.0
rest.addHeader('Content-Type', 'application/atom+xml');
rest.addHeader('GData-Version', '3.0');
final sbRequestBody = CkStringBuilder();
final sbResponseBody = CkStringBuilder();
xml.getXmlSb(sbRequestBody);
try {
rest.fullRequestSb('POST', '/m8/feeds/contacts/default/full', sbRequestBody, sbResponseBody);
} on ChilkatException catch (e) {
print(e.lastErrorText);
return;
}
// A successful response will have a status code equal to 201.
if (rest.responseStatusCode != 201) {
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 201 response was received, then the contact was successfully created,
// and there is no response body.
print('Contact created.');
}