Sample code for 30+ languages & platforms
JavaScript Requires Chilkat v11.0.0+

Download the original Gmail message as EML

See more GMail REST API Examples

Supply a Gmail message ID and request format=raw. Decode the complete MIME message directly to bytes and save them in downloaded.eml. Parse those same bytes with Chilkat.Email to read the subject, sender, and attachment count without a text-encoding round trip.

Authorize the application with https://www.googleapis.com/auth/gmail.readonly. The example reads the access token from gmail-token.json in a private working directory. Authorize a desktop application.

Google documentation

Note
This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.
JavaScript
var success = false;

//  Assumes Chilkat is unlocked. See Global Unlock Sample.

var token = new CkJsonObject();
success = token.LoadFile("gmail-token.json");
if (success !== true) {
    console.log("Could not read gmail-token.json from the private working directory.");
    return;
}

if ((token.JsonTypeOf("access_token") !== 1) || (token.StringOfEquals("access_token","",true) == true)) {
    console.log("An OAuth access token is required.");
    return;
}

var http = new CkHttp();
http.RequireSslCertVerify = true;
http.AuthToken = token.StringOf("access_token");
var resp = new CkHttpResponse();
var reply = new CkJsonObject();
var url = new CkStringBuilder();
url.Append("https://gmail.googleapis.com/gmail/v1/users/me/messages/");
url.Append("GMAIL_MESSAGE_ID");
url.Append("?format=raw");
success = http.HttpNoBody("GET",url.GetAsString(),resp);
if (resp.StatusCode == 0) {
    console.log("Gmail did not return an HTTP response.");
    return;
}

if ((success !== true) || (resp.StatusCode < 200) || (resp.StatusCode >= 300)) {
    console.log("Gmail HTTP " + resp.StatusCode);
    success = reply.Load(resp.BodyStr);
    if (success == true) {
        console.log(reply.StringOf("error.message"));
    }

    return;
}

success = reply.Load(resp.BodyStr);
if (success !== true) {
    console.log("Expected a Gmail JSON response.");
    return;
}

if ((reply.JsonTypeOf("raw") !== 1) || (reply.StringOfEquals("raw","",true) == true)) {
    console.log("Expected raw in the response.");
    return;
}

var mime = new CkBinData();
success = reply.BytesOf("raw","base64url",mime);
if (success !== true) {
    console.log("Could not decode the raw MIME.");
    return;
}

success = mime.WriteFile("downloaded.eml");
if (success !== true) {
    console.log("Could not write downloaded.eml.");
    return;
}

var email = new CkEmail();
success = email.SetFromMimeBd(mime);
if (success !== true) {
    console.log(email.LastErrorText);
    return;
}

console.log("From: " + email.From);
console.log("Subject: " + email.Subject);
console.log("Attachments: " + email.NumAttachments);