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.
Chilkat Xbase++ Downloads
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()