Sample code for 30+ languages & platforms
Xbase++ 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

Chilkat Xbase++ Downloads

Xbase++
LOCAL nSuccess
LOCAL oToken
LOCAL oHttp
LOCAL oResp
LOCAL oReply
LOCAL oUrl
LOCAL oData

nSuccess := 0

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

oToken := CreateObject("Chilkat.JsonObject")
nSuccess := oToken:LoadFile("gmail-token.json")
IF (nSuccess != 1)
    ? "Could not read gmail-token.json from the private working directory."
    oToken:destroy()
    RETURN
ENDIF

IF ((oToken:JsonTypeOf("access_token") != 1) .OR. (oToken:StringOfEquals("access_token", "", 1) == 1))
    ? "An OAuth access token is required."
    oToken:destroy()
    RETURN
ENDIF

oHttp := CreateObject("Chilkat.Http")
oHttp:RequireSslCertVerify := 1
oHttp:AuthToken := oToken:StringOf("access_token")
oResp := CreateObject("Chilkat.HttpResponse")
oReply := CreateObject("Chilkat.JsonObject")
oUrl := CreateObject("Chilkat.StringBuilder")
oUrl:Append("https://gmail.googleapis.com/gmail/v1/users/me/messages/")
oUrl:Append("GMAIL_MESSAGE_ID")
oUrl:Append("/attachments/")
oUrl:Append("GMAIL_ATTACHMENT_ID")
nSuccess := oHttp:HttpNoBody("GET", oUrl:GetAsString(), oResp)
IF (oResp:StatusCode == 0)
    ? "Gmail did not return an HTTP response."
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oUrl:destroy()
    RETURN
ENDIF

IF ((nSuccess != 1) .OR. (oResp:StatusCode < 200) .OR. (oResp:StatusCode >= 300))
    ? "Gmail HTTP " + Str(oResp:StatusCode)
    nSuccess := oReply:Load(oResp:BodyStr)
    IF (nSuccess == 1)
        ? oReply:StringOf("error.message")
    ENDIF

    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oUrl:destroy()
    RETURN
ENDIF

nSuccess := oReply:Load(oResp:BodyStr)
IF (nSuccess != 1)
    ? "Expected a Gmail JSON response."
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oUrl:destroy()
    RETURN
ENDIF

IF ((oReply:JsonTypeOf("data") != 1) .OR. (oReply:JsonTypeOf("size") != 2))
    ? "Expected attachment data and a byte count."
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oUrl:destroy()
    RETURN
ENDIF

oData := CreateObject("Chilkat.BinData")
IF (oReply:StringOfEquals("data", "", 1) != 1)
    nSuccess := oReply:BytesOf("data", "base64url", oData)
    IF (nSuccess != 1)
        ? "Could not decode the attachment."
        oToken:destroy()
        oHttp:destroy()
        oResp:destroy()
        oReply:destroy()
        oUrl:destroy()
        oData:destroy()
        RETURN
    ENDIF

ENDIF

IF (oData:NumBytes != oReply:IntOf("size"))
    ? "Attachment size mismatch."
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oUrl:destroy()
    oData:destroy()
    RETURN
ENDIF

nSuccess := oData:WriteFile("downloaded-attachment.bin")
IF (nSuccess != 1)
    ? "Could not save the attachment."
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oUrl:destroy()
    oData:destroy()
    RETURN
ENDIF

? "Saved " + Str(oData:NumBytes) + " bytes."

oToken:destroy()
oHttp:destroy()
oResp:destroy()
oReply:destroy()
oUrl:destroy()
oData:destroy()