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

Send email to blind-copy recipients with Gmail

See more GMail REST API Examples

Live send. Replace all sample addresses. Gmail takes its recipients from the submitted MIME To, Cc, and Bcc headers. Use AddBcc on a new Email and keep the Bcc header when serializing it for Gmail. Treat the submission as private because it contains the blind-copy addresses.

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 oMime
LOCAL oRequest

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."
//  Gmail needs the blind recipient in the submitted MIME; use the normal Chilkat 11.x Bcc behavior.
nSuccess := oEmail:AddBcc("Blind recipient", "blind@example.org")
IF (nSuccess != 1)
    ? oEmail:LastErrorText
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oEmail: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()
    oMime:destroy()
    RETURN
ENDIF

oRequest := CreateObject("Chilkat.JsonObject")
nSuccess := oRequest:UpdateBd("raw", "base64url", oMime)
IF (nSuccess != 1)
    ? oRequest:LastErrorText
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oEmail:destroy()
    oMime:destroy()
    oRequest:destroy()
    RETURN
ENDIF

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

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

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