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

Send a Gmail message with a file attachment

See more GMail REST API Examples

Live send. Prepare a small file named attachment.pdf and replace the sample addresses. Add the file as a MIME attachment and upload the complete message as message/rfc822. The response is a Gmail Message. For larger uploads or unreliable connections, see Google’s resumable upload guidance.

Authorize the application with https://www.googleapis.com/auth/gmail.send. 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 oEmail
LOCAL oFileData
LOCAL oMime

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")
oEmail := CreateObject("Chilkat.Email")
//  Use the authorized mailbox or one of its configured send-as addresses.
oEmail:From := "Sender <sender@example.com>"
nSuccess := oEmail:AddTo("Recipient", "recipient@example.net")
IF (nSuccess != 1)
    ? oEmail:LastErrorText
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oEmail:destroy()
    RETURN
ENDIF

oEmail:Subject := "Sample message"
oEmail:Charset := "utf-8"
oEmail:Body := "Hello from the Gmail API."
oFileData := CreateObject("Chilkat.BinData")
nSuccess := oFileData:LoadFile("attachment.pdf")
IF (nSuccess != 1)
    ? "Could not read attachment.pdf."
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oEmail:destroy()
    oFileData:destroy()
    RETURN
ENDIF

nSuccess := oEmail:AddAttachmentBd("attachment.pdf", oFileData, "application/pdf")
IF (nSuccess != 1)
    ? oEmail:LastErrorText
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oEmail:destroy()
    oFileData:destroy()
    RETURN
ENDIF

oMime := CreateObject("Chilkat.BinData")
nSuccess := oEmail:GetMimeBd(oMime)
IF (nSuccess != 1)
    ? oEmail:LastErrorText
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oEmail:destroy()
    oFileData:destroy()
    oMime:destroy()
    RETURN
ENDIF

nSuccess := oHttp:HttpBd("POST", "https://gmail.googleapis.com/upload/gmail/v1/users/me/messages/send?uploadType=media", oMime, "message/rfc822", oResp)
IF (oResp:StatusCode == 0)
    ? "Gmail did not return an HTTP response."
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oEmail:destroy()
    oFileData:destroy()
    oMime: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()
    oEmail:destroy()
    oFileData:destroy()
    oMime:destroy()
    RETURN
ENDIF

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

IF ((oReply:JsonTypeOf("id") != 1) .OR. (oReply:StringOfEquals("id", "", 1) == 1))
    ? "Expected id in the response."
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oEmail:destroy()
    oFileData:destroy()
    oMime:destroy()
    RETURN
ENDIF

? "Gmail message ID: " + oReply:StringOf("id")

oToken:destroy()
oHttp:destroy()
oResp:destroy()
oReply:destroy()
oEmail:destroy()
oFileData:destroy()
oMime:destroy()