Immediately and permanently deletes the specified message. This operation cannot be undone. Prefer messages.trash instead.

Scopes

You will need authorization for the https://mail.google.com/ scope to make a valid call.

If unset, the scope for this method defaults to https://mail.google.com/. You can set the scope for this method like this: gmail1 --scope <scope> users messages-delete ...

Required Scalar Arguments

  • <user-id> (string)
    • The user's email address. The special value me can be used to indicate the authenticated user.
  • <id> (string)
    • The ID of the message to delete.

Optional General Properties

The following properties can configure any call, and are not specific to this method.

  • -p $-xgafv=string

    • V1 error format.

  • -p access-token=string

    • OAuth access token.

  • -p alt=string

    • Data format for response.

  • -p callback=string

    • JSONP

  • -p fields=string

    • Selector specifying which fields to include in a partial response.

  • -p key=string

    • API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.

  • -p oauth-token=string

    • OAuth 2.0 token for the current user.

  • -p pretty-print=boolean

    • Returns response with indentations and line breaks.

  • -p quota-user=string

    • Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • -p upload-type=string

    • Legacy upload protocol for media (e.g. "media", "multipart").

  • -p upload-protocol=string

    • Upload protocol for media (e.g. "raw", "multipart").