Zig

Retrieve a Single Contact

See more Google APIs Examples

Demonstrates how to retrieve a single contact (by contactId) for the Google Contacts API. Zig

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

    // 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

    const json_token = try chilkat.JsonObject.init();
    defer json_token.deinit();
    json_token.loadFile("qa_data/tokens/googleContacts.json") catch {
        std.debug.print("Failed to load googleContacts.json\n", .{});
        return;
    };

    const g_auth = try chilkat.AuthGoogle.init();
    defer g_auth.deinit();
    g_auth.setAccessToken(try json_token.stringOf(alloc, "access_token"));

    const rest = try chilkat.Rest.init();
    defer rest.deinit();

    // Connect using TLS.
    const b_auto_reconnect = true;
    try rest.connect("www.google.com", 443, true, b_auto_reconnect);

    // Provide the authentication credentials (i.e. the access token)
    rest.setAuthGoogle(g_auth) catch {};

    // ----------------------------------------------
    // OK, the REST connection setup is completed..
    // ----------------------------------------------

    // To retrieve the contact, send the following:

    //     GET /m8/feeds/contacts/default/full/{contactId}
    //     GData-Version: 3.0

    rest.addHeader("GData-Version", "3.0") catch {};

    const sb_path = try chilkat.StringBuilder.init();
    defer sb_path.deinit();
    sb_path.append("/m8/feeds/contacts/default/full/{contactId}") catch {};
    // Get the contact having contactId = "7b1c7b6409e718a0"
    _ = sb_path.replace("{contactId}", "7b1c7b6409e718a0");

    const sb_response_body = try chilkat.StringBuilder.init();
    defer sb_response_body.deinit();
    rest.fullRequestNoBodySb("GET", try sb_path.getAsString(alloc), sb_response_body) catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

    // A successful response will have a status code equal to 200.
    if (rest.getResponseStatusCode() != 200) {
        std.debug.print("response status code = {d}\n", .{rest.getResponseStatusCode()});
        std.debug.print("response status text = {s}\n", .{try rest.getResponseStatusText(alloc)});
        std.debug.print("response header: {s}\n", .{try rest.getResponseHeader(alloc)});
        std.debug.print("response body: {s}\n", .{try sb_response_body.getAsString(alloc)});
        return;
    }

    // If the 200 response was received, then the contacts XML is contained
    // in the response body.
    const xml = try chilkat.Xml.init();
    defer xml.deinit();
    xml.loadSb(sb_response_body, false) catch {};

    // See below for a sample response body.
    xml.saveXml("qa_output/google_contact.xml") catch {};

    // Now let's parse the XML...
    std.debug.print("title: {s}\n", .{try xml.getChildContent(alloc, "title")});

    if (xml.chilkatPath(alloc, "gd:email|(address)")) |email_address| {
        std.debug.print("email address: {s}\n", .{email_address});
    } else |_| {}

    // The response body XML looks something like this:

    //     <?xml version="1.0" encoding="UTF-8" ?>
    //     <entry gd:etag="&quot;R3kzezVSLit7I2A9XRFaFE8DQAU.&quot;" xmlns="http://www.w3.org/2005/Atom" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gContact="http://schemas.google.com/contact/2008" xmlns:gd="http://schemas.google.com/g/2005">
    //         <id>http://www.google.com/m8/feeds/contacts/support%40chilkatcloud.com/base/7b1c7b6409e718a0</id>
    //         <updated>2016-11-18T00:41:56.783Z</updated>
    //         <app:edited xmlns:app="http://www.w3.org/2007/app">2016-11-18T00:41:56.783Z</app:edited>
    //         <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#contact" />
    //         <title>Chilkat Cloud</title>
    //         <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*" href="https://www.googleapis.com/m8/feeds/photos/media/support%40chilkatcloud.com/7b1c7b6409e718a0" gd:etag="&quot;fgVhPls4Sit7I2BWHUlTWkQMKHUZKHkkaiw.&quot;" />
    //         <link rel="self" type="application/atom+xml" href="https://www.googleapis.com/m8/feeds/contacts/support%40chilkatcloud.com/full/7b1c7b6409e718a0" />
    //         <link rel="edit" type="application/atom+xml" href="https://www.googleapis.com/m8/feeds/contacts/support%40chilkatcloud.com/full/7b1c7b6409e718a0" />
    //         <gd:name>
    //             <gd:fullName>Chilkat Cloud</gd:fullName>
    //             <gd:givenName>Chilkat</gd:givenName>
    //             <gd:familyName>Cloud</gd:familyName>
    //         </gd:name>
    //         <gd:email rel="http://schemas.google.com/g/2005#other" address="support@chilkatcloud.com" primary="true" />
    //         <gContact:groupMembershipInfo deleted="false" href="http://www.google.com/m8/feeds/groups/support%40chilkatcloud.com/base/6" />
    //     </entry>
}