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

Mark a Gmail message as read or archive it

See more GMail REST API Examples

Choose read or archive and supply a Gmail message ID. Marking a message as read removes UNREAD. Archiving removes INBOX while keeping the message available elsewhere in the mailbox. Each run performs the selected action on one message. Removing a label that is already absent is safe to repeat.

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");
$action = 'read';
$request = new COM("Chilkat.JsonObject");
if ($action == 'read') {
    $success = $request->UpdateString('removeLabelIds[0]','UNREAD');
    if ($success != 1) {
        print $request->LastErrorText . "\n";
        exit;
    }

}
else {
    if ($action != 'archive') {
        print 'Choose read or archive.' . "\n";
        exit;
    }

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

}

$url = new COM("Chilkat.StringBuilder");
$url->Append('https://gmail.googleapis.com/gmail/v1/users/me/messages/');
$url->Append('GMAIL_MESSAGE_ID');
$url->Append('/modify');
$success = $http->HttpJson('POST',$url->getAsString(),$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 'Completed ' . $action . ' for message ' . $reply->stringOf('id') . "\n";

?>