Method: users.messages.insert
Непосредственно вставляет сообщение только в почтовый ящик этого пользователя, аналогично IMAP APPEND , минуя большую часть сканирования и классификации. Не отправляет сообщение.
HTTP-запрос
- URI загрузки для запросов на загрузку мультимедиа:
POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages - URI метаданных для запросов только метаданных:
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
userId | string Адрес электронной почты пользователя. Специальное значение me можно использовать для указания аутентифицированного пользователя. |
Параметры запроса
| Параметры |
|---|
internalDateSource | enum ( InternalDateSource ) Источник внутренней даты сообщения Gmail. |
deleted | boolean Отметьте электронное письмо как безвозвратно удаленное (не как мусор) и доступное в Google Сейфе только администратору Сейфа. Используется только для учетных записей Google Workspace. |
Тело запроса
Тело запроса содержит экземпляр Message .
Тело ответа
В случае успеха тело ответа содержит экземпляр Message .
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://mail.google.com/ -
https://www.googleapis.com/auth/gmail.modify -
https://www.googleapis.com/auth/gmail.insert
Дополнительную информацию см. в руководстве по авторизации .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-10-30 UTC.
[null,null,["Последнее обновление: 2024-10-30 UTC."],[[["Directly inserts a message into the user's mailbox, similar to `IMAP APPEND`, bypassing most scanning and classification."],["Supports two types of requests: uploading media content (`POST /upload/...`) and sending metadata only (`POST /...`)."],["Requires providing the user's email address (`userId`) as a path parameter and offers optional query parameters to control internal date source and deletion behavior."],["The request and response bodies both utilize the `Message` resource for structuring email data."],["To authorize, you'll need one of the specified OAuth scopes related to Gmail access and modification."]]],["This content outlines the process for directly inserting a message into a user's Gmail mailbox. Key actions include using `POST` requests to either an upload URI (`/upload/gmail/v1/users/{userId}/messages`) or a metadata URI (`/gmail/v1/users/{userId}/messages`). The `userId` path parameter identifies the user, and query parameters like `internalDateSource` and `deleted` provide further message properties. A `Message` instance is sent in the request and returned in the response. Authentication requires specific OAuth scopes.\n"]]
