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

Download a Gmail attachment by ID

See more GMail REST API Examples

Use a Gmail message ID and a body.attachmentId from the same message. Find the attachment ID by inspecting its MIME parts. Decode the returned data as base64url, check the decoded byte count, and save it to an application-chosen path. A part containing body.data can be decoded directly from the full message.

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("/attachments/");
url.Append("GMAIL_ATTACHMENT_ID");
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("data") !== 1) || (reply.JsonTypeOf("size") !== 2)) {
    console.log("Expected attachment data and a byte count.");
    return;
}

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

}

if (data.NumBytes !== reply.IntOf("size")) {
    console.log("Attachment size mismatch.");
    return;
}

success = data.WriteFile("downloaded-attachment.bin");
if (success !== true) {
    console.log("Could not save the attachment.");
    return;
}

console.log("Saved " + data.NumBytes + " bytes.");