Google resource: gmail users messages (2026-10-27)

Get started · Contract 2026-10-27

Operation	TypeScript	Python
Deletes many messages by message ID. Provides no guarantees that messages were not already deleted or even existed at all.	gmailUsersMessages.gmailUsersMessagesBatchDelete	gmail_users_messages.gmail_users_messages_batch_delete
Modifies the labels and the Classification Label values on the specified messages. For administrators modifying messages for users in their organization, requests require authorization with a [service account](https://developers.google.com/identity/protocols/OAuth2ServiceAccount) that has [domain-wide delegation authority](https://developers.google.com/identity/protocols/OAuth2ServiceAccount#delegatingauthority) to impersonate users with the `https://www.googleapis.com/auth/gmail.modify.restricted` scope.	gmailUsersMessages.gmailUsersMessagesBatchModify	gmail_users_messages.gmail_users_messages_batch_modify
Immediately and permanently deletes the specified message. This operation cannot be undone. Prefer `messages.trash` instead.	gmailUsersMessages.gmailUsersMessagesDelete	gmail_users_messages.gmail_users_messages_delete
Gets the specified message.	gmailUsersMessages.gmailUsersMessagesGet	gmail_users_messages.gmail_users_messages_get
Imports a message into only this user’s mailbox, with standard email delivery scanning and classification similar to receiving via SMTP. This method doesn’t perform SPF checks, so it might not work for some spam messages, such as those attempting to perform domain spoofing. This method does not send a message. Note that the maximum size of the message is 150 MB.	gmailUsersMessages.gmailUsersMessagesImport	gmail_users_messages.gmail_users_messages_import
Directly inserts a message into only this user’s mailbox similar to `IMAP APPEND`, bypassing most scanning and classification. Does not send a message. For more information, see [Create and send email messages](https://developers.google.com/workspace/gmail/api/guides/sending).	gmailUsersMessages.gmailUsersMessagesInsert	gmail_users_messages.gmail_users_messages_insert
Lists the messages in the user’s mailbox. For more information, see [List Gmail messages](https://developers.google.com/workspace/gmail/api/guides/list-messages).	gmailUsersMessages.gmailUsersMessagesList	gmail_users_messages.gmail_users_messages_list
Modifies the labels and the Classification Label values on the specified message. For administrators modifying message for users in their organization, requests require authorization with a [service account](https://developers.google.com/identity/protocols/OAuth2ServiceAccount) that has [domain-wide delegation authority](https://developers.google.com/identity/protocols/OAuth2ServiceAccount#delegatingauthority) to impersonate users with the `https://www.googleapis.com/auth/gmail.modify.restricted` scope.	gmailUsersMessages.gmailUsersMessagesModify	gmail_users_messages.gmail_users_messages_modify
Sends the specified message to the recipients in the `To`, `Cc`, and `Bcc` headers. For more information, see [Create and send email messages](https://developers.google.com/workspace/gmail/api/guides/sending).	gmailUsersMessages.gmailUsersMessagesSend	gmail_users_messages.gmail_users_messages_send
Moves the specified message to the trash.	gmailUsersMessages.gmailUsersMessagesTrash	gmail_users_messages.gmail_users_messages_trash
Removes the specified message from the trash.	gmailUsersMessages.gmailUsersMessagesUntrash	gmail_users_messages.gmail_users_messages_untrash