Sample code for 30+ languages & platforms
C++

Download a Specific GMail Message into a Chilkat Email Object

See more GMail REST API Examples

Demonstrates how to download a GMail message into a Chilkat Email object.

Chilkat C++ Downloads

C++
#include <CkHttp.h>
#include <CkStringBuilder.h>
#include <CkJsonObject.h>
#include <CkEmail.h>

void ChilkatSample(void)
    {
    bool success = false;

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

    CkHttp http;
    http.put_AuthToken("GMAIL-ACCESS-TOKEN");

    // The id of the GMail message to download.
    const char *id = "166e50fed0b9b0cb";
    const char *userId = "me";

    http.SetUrlVar("userId","me");
    http.SetUrlVar("id",id);

    // Fetch the email.
    const char *url = "https://www.googleapis.com/gmail/v1/users/{$userId}/messages/{$id}?format=raw";
    CkStringBuilder sbJson;
    success = http.DownloadSb(url,"utf-8",sbJson);
    if (success != true) {
        std::cout << http.lastErrorText() << "\r\n";
        return;
    }

    CkJsonObject json;
    json.LoadSb(sbJson);
    json.put_EmitCompact(false);

    if (http.get_LastStatus() != 200) {
        std::cout << json.emit() << "\r\n";
        std::cout << "Failed." << "\r\n";
        return;
    }

    // The returned JSON contains something like this:

    // {
    //   "id": "166e50fed0b9b0cb",
    //   "threadId": "166e50fed0b9b0cb",
    //   "labelIds": [
    //     "CATEGORY_SOCIAL",
    //     "INBOX"
    //   ],
    //   "snippet": "...",
    //   "historyId": "582477",
    //   "internalDate": "1541441317000",
    //   "sizeEstimate": 28603,
    //   "raw": "BASE64URL_CONTENT"
    // }

    // The RFC822 MIME of the email is contained in the "raw" as a base64URL encoded string.
    // Let's decode and load into a Chilkat email object..
    CkStringBuilder sbRaw;
    json.StringOfSb("raw",sbRaw);
    sbRaw.Decode("base64url","utf-8");

    CkEmail email;
    email.SetFromMimeSb(sbRaw);

    // Now we can use the email API to do whatever we desire..
    std::cout << "From: " << email.fromAddress() << "\r\n";
    std::cout << "Subject: " << email.subject() << "\r\n";
    // ...
    }