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

Move one Gmail message to Trash

See more GMail REST API Examples

Supply the Gmail message ID, then post an empty body to its trash endpoint. Gmail returns the updated message. While the message remains in Trash it can be restored with messages.untrash.

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 CkPerl Downloads

CkPerl
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("/trash");
$success = $http->HttpNoBody("POST",$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("id") != 1) or ($reply->StringOfEquals("id","",1) == 1)) {
    print "Expected id in the response." . "\r\n";
    exit;
}

print "Moved to Trash: " . $reply->stringOf("id") . "\r\n";