Sample code for 30+ languages & platforms
Java

Google Contacts - Create New Contact

See more Google APIs Examples

Demonstrates how to create a new contact for the Google Contacts API.

Chilkat Java Downloads

Chilkat2 Java
import com.chilkatsoft.chilkat2.AuthGoogle;
import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.JsonObject;
import com.chilkatsoft.chilkat2.Rest;
import com.chilkatsoft.chilkat2.StringBuilder;
import com.chilkatsoft.chilkat2.Xml;

public class ChilkatExample {

    public static void main(String[] args) {
        // This example requires the Chilkat API to have been previously unlocked.
        // See Global Unlock Sample for sample code.

        // First create a new contact XML.
        Xml xml = new Xml();
        xml.setTag("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");

        System.out.println(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

        JsonObject jsonToken = new JsonObject();
        try {
            jsonToken.loadFile("qa_data/tokens/googleContacts.json");
        } catch (ChilkatException e) {
            System.out.println("Failed to load googleContacts.json");
            return;
        }

        AuthGoogle gAuth = new AuthGoogle();
        gAuth.setAccessToken(jsonToken.stringOf("access_token"));

        Rest rest = new Rest();

        // Connect using TLS.
        boolean 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");

        StringBuilder sbRequestBody = new StringBuilder();
        StringBuilder sbResponseBody = new StringBuilder();
        xml.getXmlSb(sbRequestBody);
        try {
            rest.fullRequestSb("POST", "/m8/feeds/contacts/default/full", sbRequestBody, sbResponseBody);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        // A successful response will have a status code equal to 201.
        if (rest.getResponseStatusCode() != 201) {
            System.out.println("response status code = " + rest.getResponseStatusCode());
            System.out.println("response status text = " + rest.getResponseStatusText());
            System.out.println("response header: " + rest.getResponseHeader());
            System.out.println("response body: " + sbResponseBody.getAsString());
            return;
        }

        // If the 201 response was received, then the contact was successfully created,
        // and there is no response body.
        System.out.println("Contact created.");
    }
}