Sample code for 30+ languages & platforms
CkPython

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

CkPython
import sys
import chilkat

success = False

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

http = chilkat.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())
    sys.exit()

print("status = " + str(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):
    print(responseStr)
    print("Failed.")
    sys.exit()

print("Message deleted!")