Sample code for 30+ languages & platforms
Objective-C

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 Objective-C Downloads

Objective-C
#import <CkoHttp.h>
#import <NSString.h>

BOOL success = NO;

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

CkoHttp *http = [[CkoHttp alloc] init];
http.AuthToken = @"GMAIL-ACCESS-TOKEN";

// The id of the GMail message to delete.
NSString *id = @"1669cc9a926bb8c1";
NSString *userId = @"me";

[http SetUrlVar: @"userId" value: @"me"];
[http SetUrlVar: @"id" value: id];

// Delete the email.
NSString *url = @"https://www.googleapis.com/gmail/v1/users/{$userId}/messages/{$id}";
NSString *responseStr = [http QuickDeleteStr: url];
if (http.LastMethodSuccess != YES) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

NSLog(@"%@%d",@"status = ",[http.LastStatus intValue]);

// 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 intValue] != 204) {
    NSLog(@"%@",responseStr);
    NSLog(@"%@",@"Failed.");
    return;
}

NSLog(@"%@",@"Message deleted!");