Sample code for 30+ languages & platforms
PHP Extension

Permanently Delete a Specific GMail Message

See more GMail REST API Examples

Immediately and permanently deletes the specified message. This operation cannot be undone. (This is not the same as moving a message to Trash.)

Chilkat PHP Extension Downloads

PHP Extension
<?php

include("chilkat.php");

$success = false;

// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

$http = new CkHttp();
$http->put_AuthToken('GMAIL-ACCESS-TOKEN');

// The id of the GMail message to delete.
$id = '1669cc9a926bb8c1';
$userId = 'me';

$http->SetUrlVar('userId','me');
$http->SetUrlVar('id',$id);

// Delete the email.
$url = 'https://www.googleapis.com/gmail/v1/users/{$userId}/messages/{$id}';
$responseStr = $http->quickDeleteStr($url);
if ($http->get_LastMethodSuccess() != true) {
    print $http->lastErrorText() . "\n";
    exit;
}

print 'status = ' . $http->get_LastStatus() . "\n";

// A 204 response indicate success.
// It is common for HTTP DELETE operations to respond with a 204 status code with an empty body for success.
// You'll find many REST APIs follow this custom..
if ($http->get_LastStatus() != 204) {
    print $responseStr . "\n";
    print 'Failed.' . "\n";
    exit;
}

print 'Message deleted!' . "\n";

?>