Sample code for 30+ languages & platforms
Java

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

Java
import com.chilkatsoft.*;

public class ChilkatExample {

  static {
    try {
        System.loadLibrary("chilkat");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    boolean success = false;

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

    CkHttp http = new CkHttp();
    http.put_AuthToken("GMAIL-ACCESS-TOKEN");

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

    http.SetUrlVar("userId","me");
    http.SetUrlVar("id",id);

    // Delete the email.
    String url = "https://www.googleapis.com/gmail/v1/users/{$userId}/messages/{$id}";
    String responseStr = http.quickDeleteStr(url);
    if (http.get_LastMethodSuccess() != true) {
        System.out.println(http.lastErrorText());
        return;
        }

    System.out.println("status = " + http.get_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.get_LastStatus() != 204) {
        System.out.println(responseStr);
        System.out.println("Failed.");
        return;
        }

    System.out.println("Message deleted!");
  }
}