Sample code for 30+ languages & platforms
Delphi ActiveX

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

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

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Integer;
http: TChilkatHttp;
id: WideString;
userId: WideString;
url: WideString;
responseStr: WideString;

begin
success := 0;

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

http := TChilkatHttp.Create(Self);
http.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.LastMethodSuccess <> 1) then
  begin
    Memo1.Lines.Add(http.LastErrorText);
    Exit;
  end;

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

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

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