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

Reply to a message in its existing Gmail thread

See more GMail REST API Examples

Live send. Supply the Gmail ID of a received message and use an authorized From address. Fetch its raw MIME so Chilkat.Email can parse encoded headers and recipient addresses. Send a plain-text reply to Reply-To, falling back to From. The reply goes to the original sender or reply address.

The request supplies Gmail’s threadId and matching Subject. The MIME In-Reply-To contains the original RFC Message-ID. References preserves the conversation ancestry and appends that Message-ID. Select a message with a valid Message-ID and review its recipient before running this sending example. Authorize both gmail.readonly and gmail.send, or use gmail.modify as shown below.

Authorize the application with https://www.googleapis.com/auth/gmail.modify. 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 cThreadId
LOCAL oOriginalMime
LOCAL oOriginal
LOCAL cMessageIdHeader
LOCAL oEmail
LOCAL cReplyAddress
LOCAL oReferences
LOCAL cPreviousReferences
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")
oUrl := CreateObject("Chilkat.StringBuilder")
oUrl:Append("https://gmail.googleapis.com/gmail/v1/users/me/messages/")
oUrl:Append("GMAIL_MESSAGE_ID")
oUrl:Append("?format=raw")
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("threadId") != 1) .OR. (oReply:StringOfEquals("threadId", "", 1) == 1))
    ? "Expected threadId in the response."
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oUrl:destroy()
    RETURN
ENDIF

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

cThreadId := oReply:StringOf("threadId")
oOriginalMime := CreateObject("Chilkat.BinData")
nSuccess := oReply:BytesOf("raw", "base64url", oOriginalMime)
IF (nSuccess != 1)
    ? oReply:LastErrorText
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oUrl:destroy()
    oOriginalMime:destroy()
    RETURN
ENDIF

oOriginal := CreateObject("Chilkat.Email")
nSuccess := oOriginal:SetFromMimeBd(oOriginalMime)
IF (nSuccess != 1)
    ? oOriginal:LastErrorText
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oUrl:destroy()
    oOriginalMime:destroy()
    oOriginal:destroy()
    RETURN
ENDIF

cMessageIdHeader := oOriginal:GetHeaderField("Message-ID")
IF ((oOriginal:LastMethodSuccess != 1) .OR. (cMessageIdHeader == ""))
    ? "The original message needs a Message-ID for this threaded reply."
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oUrl:destroy()
    oOriginalMime:destroy()
    oOriginal:destroy()
    RETURN
ENDIF

oEmail := CreateObject("Chilkat.Email")
oEmail:From := "Sender <sender@example.com>"
//  Use the parsed Reply-To mailbox list when present, otherwise use From.
cReplyAddress := oOriginal:ReplyTo
IF (cReplyAddress == "")
    cReplyAddress := oOriginal:From
ENDIF

nSuccess := oEmail:AddMultipleTo(cReplyAddress)
IF (nSuccess != 1)
    ? oEmail:LastErrorText
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oUrl:destroy()
    oOriginalMime:destroy()
    oOriginal:destroy()
    oEmail:destroy()
    RETURN
ENDIF

IF (oEmail:NumTo == 0)
    ? "The original message has no usable reply address."
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oUrl:destroy()
    oOriginalMime:destroy()
    oOriginal:destroy()
    oEmail:destroy()
    RETURN
ENDIF

oEmail:Subject := oOriginal:Subject
oEmail:Charset := "utf-8"
oEmail:Body := "Thank you for your message."
oEmail:AddHeaderField("In-Reply-To", cMessageIdHeader)
oReferences := CreateObject("Chilkat.StringBuilder")
cPreviousReferences := oOriginal:GetHeaderField("References")
IF ((oOriginal:LastMethodSuccess == 1) .AND. (cPreviousReferences != ""))
    oReferences:Append(cPreviousReferences)
    oReferences:Append(" ")
ENDIF

oReferences:Append(cMessageIdHeader)
oEmail:AddHeaderField("References", oReferences:GetAsString())
oMime := CreateObject("Chilkat.BinData")
nSuccess := oEmail:GetMimeBd(oMime)
IF (nSuccess != 1)
    ? oEmail:LastErrorText
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oUrl:destroy()
    oOriginalMime:destroy()
    oOriginal:destroy()
    oEmail:destroy()
    oReferences: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()
    oUrl:destroy()
    oOriginalMime:destroy()
    oOriginal:destroy()
    oEmail:destroy()
    oReferences:destroy()
    oMime:destroy()
    oRequest:destroy()
    RETURN
ENDIF

nSuccess := oRequest:UpdateString("threadId", cThreadId)
IF (nSuccess != 1)
    ? oRequest:LastErrorText
    oToken:destroy()
    oHttp:destroy()
    oResp:destroy()
    oReply:destroy()
    oUrl:destroy()
    oOriginalMime:destroy()
    oOriginal:destroy()
    oEmail:destroy()
    oReferences: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()
    oUrl:destroy()
    oOriginalMime:destroy()
    oOriginal:destroy()
    oEmail:destroy()
    oReferences: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()
    oUrl:destroy()
    oOriginalMime:destroy()
    oOriginal:destroy()
    oEmail:destroy()
    oReferences: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()
    oUrl:destroy()
    oOriginalMime:destroy()
    oOriginal:destroy()
    oEmail:destroy()
    oReferences: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()
    oUrl:destroy()
    oOriginalMime:destroy()
    oOriginal:destroy()
    oEmail:destroy()
    oReferences:destroy()
    oMime:destroy()
    oRequest:destroy()
    RETURN
ENDIF

? "Sent reply ID: " + oReply:StringOf("id")
? "Thread ID: " + oReply:StringOf("threadId")

oToken:destroy()
oHttp:destroy()
oResp:destroy()
oReply:destroy()
oUrl:destroy()
oOriginalMime:destroy()
oOriginal:destroy()
oEmail:destroy()
oReferences:destroy()
oMime:destroy()
oRequest:destroy()