Sample code for 30+ languages & platforms
PowerShell

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

PowerShell
Add-Type -Path "C:\chilkat\ChilkatDotNet47-x64\ChilkatDotNet47.dll"

$success = $false

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

$http = New-Object Chilkat.Http
$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 -ne $true) {
    $($http.LastErrorText)
    exit
}

$("status = " + $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 -ne 204) {
    $($responseStr)
    $("Failed.")
    exit
}

$("Message deleted!")