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.
v11.4.0 or greater.
var success = false;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
var token = new CkJsonObject();
success = token.LoadFile("gmail-token.json");
if (success !== true) {
console.log("Could not read gmail-token.json from the private working directory.");
return;
}
if ((token.JsonTypeOf("access_token") !== 1) || (token.StringOfEquals("access_token","",true) == true)) {
console.log("An OAuth access token is required.");
return;
}
var http = new CkHttp();
http.RequireSslCertVerify = true;
http.AuthToken = token.StringOf("access_token");
var resp = new CkHttpResponse();
var reply = new CkJsonObject();
var url = new CkStringBuilder();
url.Append("https://gmail.googleapis.com/gmail/v1/users/me/messages/");
url.Append("GMAIL_MESSAGE_ID");
url.Append("?format=raw");
success = http.HttpNoBody("GET",url.GetAsString(),resp);
if (resp.StatusCode == 0) {
console.log("Gmail did not return an HTTP response.");
return;
}
if ((success !== true) || (resp.StatusCode < 200) || (resp.StatusCode >= 300)) {
console.log("Gmail HTTP " + resp.StatusCode);
success = reply.Load(resp.BodyStr);
if (success == true) {
console.log(reply.StringOf("error.message"));
}
return;
}
success = reply.Load(resp.BodyStr);
if (success !== true) {
console.log("Expected a Gmail JSON response.");
return;
}
if ((reply.JsonTypeOf("threadId") !== 1) || (reply.StringOfEquals("threadId","",true) == true)) {
console.log("Expected threadId in the response.");
return;
}
if ((reply.JsonTypeOf("raw") !== 1) || (reply.StringOfEquals("raw","",true) == true)) {
console.log("Expected raw in the response.");
return;
}
var threadId = reply.StringOf("threadId");
var originalMime = new CkBinData();
success = reply.BytesOf("raw","base64url",originalMime);
if (success !== true) {
console.log(reply.LastErrorText);
return;
}
var original = new CkEmail();
success = original.SetFromMimeBd(originalMime);
if (success !== true) {
console.log(original.LastErrorText);
return;
}
var messageIdHeader = original.GetHeaderField("Message-ID");
if ((original.LastMethodSuccess !== true) || (messageIdHeader == "")) {
console.log("The original message needs a Message-ID for this threaded reply.");
return;
}
var email = new CkEmail();
email.From = "Sender <sender@example.com>";
// Use the parsed Reply-To mailbox list when present, otherwise use From.
var replyAddress = original.ReplyTo;
if (replyAddress == "") {
replyAddress = original.From;
}
success = email.AddMultipleTo(replyAddress);
if (success !== true) {
console.log(email.LastErrorText);
return;
}
if (email.NumTo == 0) {
console.log("The original message has no usable reply address.");
return;
}
email.Subject = original.Subject;
email.Charset = "utf-8";
email.Body = "Thank you for your message.";
email.AddHeaderField("In-Reply-To",messageIdHeader);
var references = new CkStringBuilder();
var previousReferences = original.GetHeaderField("References");
if ((original.LastMethodSuccess == true) && (previousReferences !== "")) {
references.Append(previousReferences);
references.Append(" ");
}
references.Append(messageIdHeader);
email.AddHeaderField("References",references.GetAsString());
var mime = new CkBinData();
success = email.GetMimeBd(mime);
if (success !== true) {
console.log(email.LastErrorText);
return;
}
var request = new CkJsonObject();
success = request.UpdateBd("raw","base64url",mime);
if (success !== true) {
console.log(request.LastErrorText);
return;
}
success = request.UpdateString("threadId",threadId);
if (success !== true) {
console.log(request.LastErrorText);
return;
}
success = http.HttpJson("POST","https://gmail.googleapis.com/gmail/v1/users/me/messages/send",request,"application/json",resp);
if (resp.StatusCode == 0) {
console.log("Gmail did not return an HTTP response.");
return;
}
if ((success !== true) || (resp.StatusCode < 200) || (resp.StatusCode >= 300)) {
console.log("Gmail HTTP " + resp.StatusCode);
success = reply.Load(resp.BodyStr);
if (success == true) {
console.log(reply.StringOf("error.message"));
}
return;
}
success = reply.Load(resp.BodyStr);
if (success !== true) {
console.log("Expected a Gmail JSON response.");
return;
}
if ((reply.JsonTypeOf("id") !== 1) || (reply.StringOfEquals("id","",true) == true)) {
console.log("Expected id in the response.");
return;
}
console.log("Sent reply ID: " + reply.StringOf("id"));
console.log("Thread ID: " + reply.StringOf("threadId"));