Sample code for 30+ languages & platforms
PHP ActiveX 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 PHP ActiveX Downloads

PHP ActiveX
<?php

$success = 0;

//  Assumes Chilkat is unlocked. See Global Unlock Sample.

$token = new COM("Chilkat.JsonObject");
$success = $token->LoadFile('gmail-token.json');
if ($success != 1) {
    print 'Could not read gmail-token.json from the private working directory.' . "\n";
    exit;
}

if (($token->JsonTypeOf('access_token') != 1) or ($token->StringOfEquals('access_token','',1) == 1)) {
    print 'An OAuth access token is required.' . "\n";
    exit;
}

$http = new COM("Chilkat.Http");
$http->RequireSslCertVerify = 1;
$http->AuthToken = $token->stringOf('access_token');
$resp = new COM("Chilkat.HttpResponse");
$reply = new COM("Chilkat.JsonObject");
$url = new COM("Chilkat.StringBuilder");
$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) {
    print 'Gmail did not return an HTTP response.' . "\n";
    exit;
}

if (($success != 1) or ($resp->StatusCode < 200) or ($resp->StatusCode >= 300)) {
    print 'Gmail HTTP ' . $resp->StatusCode . "\n";
    $success = $reply->Load($resp->BodyStr);
    if ($success == 1) {
        print $reply->stringOf('error.message') . "\n";
    }

    exit;
}

$success = $reply->Load($resp->BodyStr);
if ($success != 1) {
    print 'Expected a Gmail JSON response.' . "\n";
    exit;
}

if (($reply->JsonTypeOf('threadId') != 1) or ($reply->StringOfEquals('threadId','',1) == 1)) {
    print 'Expected threadId in the response.' . "\n";
    exit;
}

if (($reply->JsonTypeOf('raw') != 1) or ($reply->StringOfEquals('raw','',1) == 1)) {
    print 'Expected raw in the response.' . "\n";
    exit;
}

$threadId = $reply->stringOf('threadId');
$originalMime = new COM("Chilkat.BinData");
$success = $reply->BytesOf('raw','base64url',$originalMime);
if ($success != 1) {
    print $reply->LastErrorText . "\n";
    exit;
}

$original = new COM("Chilkat.Email");
$success = $original->SetFromMimeBd($originalMime);
if ($success != 1) {
    print $original->LastErrorText . "\n";
    exit;
}

$messageIdHeader = $original->getHeaderField('Message-ID');
if (($original->LastMethodSuccess != 1) or ($messageIdHeader == '')) {
    print 'The original message needs a Message-ID for this threaded reply.' . "\n";
    exit;
}

$email = new COM("Chilkat.Email");
$email->From = 'Sender <sender@example.com>';
//  Use the parsed Reply-To mailbox list when present, otherwise use From.
$replyAddress = $original->ReplyTo;
if ($replyAddress == '') {
    $replyAddress = $original->From;
}

$success = $email->AddMultipleTo($replyAddress);
if ($success != 1) {
    print $email->LastErrorText . "\n";
    exit;
}

if ($email->NumTo == 0) {
    print 'The original message has no usable reply address.' . "\n";
    exit;
}

$email->Subject = $original->Subject;
$email->Charset = 'utf-8';
$email->Body = 'Thank you for your message.';
$email->AddHeaderField('In-Reply-To',$messageIdHeader);
$references = new COM("Chilkat.StringBuilder");
$previousReferences = $original->getHeaderField('References');
if (($original->LastMethodSuccess == 1) and ($previousReferences != '')) {
    $references->Append($previousReferences);
    $references->Append(' ');
}

$references->Append($messageIdHeader);
$email->AddHeaderField('References',$references->getAsString());
$mime = new COM("Chilkat.BinData");
$success = $email->GetMimeBd($mime);
if ($success != 1) {
    print $email->LastErrorText . "\n";
    exit;
}

$request = new COM("Chilkat.JsonObject");
$success = $request->UpdateBd('raw','base64url',$mime);
if ($success != 1) {
    print $request->LastErrorText . "\n";
    exit;
}

$success = $request->UpdateString('threadId',$threadId);
if ($success != 1) {
    print $request->LastErrorText . "\n";
    exit;
}

$success = $http->HttpJson('POST','https://gmail.googleapis.com/gmail/v1/users/me/messages/send',$request,'application/json',$resp);
if ($resp->StatusCode == 0) {
    print 'Gmail did not return an HTTP response.' . "\n";
    exit;
}

if (($success != 1) or ($resp->StatusCode < 200) or ($resp->StatusCode >= 300)) {
    print 'Gmail HTTP ' . $resp->StatusCode . "\n";
    $success = $reply->Load($resp->BodyStr);
    if ($success == 1) {
        print $reply->stringOf('error.message') . "\n";
    }

    exit;
}

$success = $reply->Load($resp->BodyStr);
if ($success != 1) {
    print 'Expected a Gmail JSON response.' . "\n";
    exit;
}

if (($reply->JsonTypeOf('id') != 1) or ($reply->StringOfEquals('id','',1) == 1)) {
    print 'Expected id in the response.' . "\n";
    exit;
}

print 'Sent reply ID: ' . $reply->stringOf('id') . "\n";
print 'Thread ID: ' . $reply->stringOf('threadId') . "\n";

?>