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 CkPerl Downloads
use chilkat();
$success = 0;
# Assumes Chilkat is unlocked. See Global Unlock Sample.
$token = chilkat::CkJsonObject->new();
$success = $token->LoadFile("gmail-token.json");
if ($success != 1) {
print "Could not read gmail-token.json from the private working directory." . "\r\n";
exit;
}
if (($token->JsonTypeOf("access_token") != 1) or ($token->StringOfEquals("access_token","",1) == 1)) {
print "An OAuth access token is required." . "\r\n";
exit;
}
$http = chilkat::CkHttp->new();
$http->put_RequireSslCertVerify(1);
$http->put_AuthToken($token->stringOf("access_token"));
$resp = chilkat::CkHttpResponse->new();
$reply = chilkat::CkJsonObject->new();
$url = chilkat::CkStringBuilder->new();
$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->get_StatusCode() == 0) {
print "Gmail did not return an HTTP response." . "\r\n";
exit;
}
if (($success != 1) or ($resp->get_StatusCode() < 200) or ($resp->get_StatusCode() >= 300)) {
print "Gmail HTTP " . $resp->get_StatusCode() . "\r\n";
$success = $reply->Load($resp->bodyStr());
if ($success == 1) {
print $reply->stringOf("error.message") . "\r\n";
}
exit;
}
$success = $reply->Load($resp->bodyStr());
if ($success != 1) {
print "Expected a Gmail JSON response." . "\r\n";
exit;
}
if (($reply->JsonTypeOf("threadId") != 1) or ($reply->StringOfEquals("threadId","",1) == 1)) {
print "Expected threadId in the response." . "\r\n";
exit;
}
if (($reply->JsonTypeOf("raw") != 1) or ($reply->StringOfEquals("raw","",1) == 1)) {
print "Expected raw in the response." . "\r\n";
exit;
}
$threadId = $reply->stringOf("threadId");
$originalMime = chilkat::CkBinData->new();
$success = $reply->BytesOf("raw","base64url",$originalMime);
if ($success != 1) {
print $reply->lastErrorText() . "\r\n";
exit;
}
$original = chilkat::CkEmail->new();
$success = $original->SetFromMimeBd($originalMime);
if ($success != 1) {
print $original->lastErrorText() . "\r\n";
exit;
}
$messageIdHeader = $original->getHeaderField("Message-ID");
if (($original->get_LastMethodSuccess() != 1) or ($messageIdHeader == "")) {
print "The original message needs a Message-ID for this threaded reply." . "\r\n";
exit;
}
$email = chilkat::CkEmail->new();
$email->put_From('Sender <sender@example.com>');
# Use the parsed Reply-To mailbox list when present, otherwise use From.
$replyAddress = $original->replyTo();
if ($replyAddress == "") {
$replyAddress = $original->ck_from();
}
$success = $email->AddMultipleTo($replyAddress);
if ($success != 1) {
print $email->lastErrorText() . "\r\n";
exit;
}
if ($email->get_NumTo() == 0) {
print "The original message has no usable reply address." . "\r\n";
exit;
}
$email->put_Subject($original->subject());
$email->put_Charset("utf-8");
$email->put_Body("Thank you for your message.");
$email->AddHeaderField("In-Reply-To",$messageIdHeader);
$references = chilkat::CkStringBuilder->new();
$previousReferences = $original->getHeaderField("References");
if (($original->get_LastMethodSuccess() == 1) and ($previousReferences != "")) {
$references->Append($previousReferences);
$references->Append(" ");
}
$references->Append($messageIdHeader);
$email->AddHeaderField("References",$references->getAsString());
$mime = chilkat::CkBinData->new();
$success = $email->GetMimeBd($mime);
if ($success != 1) {
print $email->lastErrorText() . "\r\n";
exit;
}
$request = chilkat::CkJsonObject->new();
$success = $request->UpdateBd("raw","base64url",$mime);
if ($success != 1) {
print $request->lastErrorText() . "\r\n";
exit;
}
$success = $request->UpdateString("threadId",$threadId);
if ($success != 1) {
print $request->lastErrorText() . "\r\n";
exit;
}
$success = $http->HttpJson("POST","https://gmail.googleapis.com/gmail/v1/users/me/messages/send",$request,"application/json",$resp);
if ($resp->get_StatusCode() == 0) {
print "Gmail did not return an HTTP response." . "\r\n";
exit;
}
if (($success != 1) or ($resp->get_StatusCode() < 200) or ($resp->get_StatusCode() >= 300)) {
print "Gmail HTTP " . $resp->get_StatusCode() . "\r\n";
$success = $reply->Load($resp->bodyStr());
if ($success == 1) {
print $reply->stringOf("error.message") . "\r\n";
}
exit;
}
$success = $reply->Load($resp->bodyStr());
if ($success != 1) {
print "Expected a Gmail JSON response." . "\r\n";
exit;
}
if (($reply->JsonTypeOf("id") != 1) or ($reply->StringOfEquals("id","",1) == 1)) {
print "Expected id in the response." . "\r\n";
exit;
}
print "Sent reply ID: " . $reply->stringOf("id") . "\r\n";
print "Thread ID: " . $reply->stringOf("threadId") . "\r\n";