Sample code for 30+ languages & platforms
Delphi DLL

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 Delphi DLL Downloads

Delphi DLL
uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Http;

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
http: HCkHttp;
id: PWideChar;
userId: PWideChar;
url: PWideChar;
responseStr: PWideChar;

begin
success := False;

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

http := CkHttp_Create();
CkHttp_putAuthToken(http,'GMAIL-ACCESS-TOKEN');

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

CkHttp_SetUrlVar(http,'userId','me');
CkHttp_SetUrlVar(http,'id',id);

// Delete the email.
url := 'https://www.googleapis.com/gmail/v1/users/{$userId}/messages/{$id}';
responseStr := CkHttp__quickDeleteStr(http,url);
if (CkHttp_getLastMethodSuccess(http) <> True) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;

Memo1.Lines.Add('status = ' + IntToStr(CkHttp_getLastStatus(http)));

// 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 (CkHttp_getLastStatus(http) <> 204) then
  begin
    Memo1.Lines.Add(responseStr);
    Memo1.Lines.Add('Failed.');
    Exit;
  end;

Memo1.Lines.Add('Message deleted!');

CkHttp_Dispose(http);

end;