Method: users.messages.import
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Импортирует сообщение только в почтовый ящик этого пользователя со стандартным сканированием и классификацией доставки электронной почты, аналогичным получению через SMTP. Этот метод не выполняет проверки SPF, поэтому он может не работать для некоторых спам-сообщений, например тех, которые пытаются выполнить подмену домена. Этот метод не отправляет сообщение.
HTTP-запрос
- URI загрузки для запросов на загрузку мультимедиа:
POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import
- URI метаданных для запросов только метаданных:
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры |
---|
userId | string Адрес электронной почты пользователя. Специальное значение me можно использовать для указания аутентифицированного пользователя. |
Параметры запроса
Параметры |
---|
internalDateSource | enum ( InternalDateSource ) Источник внутренней даты сообщения Gmail. |
neverMarkSpam | boolean Не обращайте внимания на решение классификатора спама Gmail и никогда не отмечайте это письмо в почтовом ящике как СПАМ. |
processForCalendar | boolean Обработка приглашений календаря в электронном письме и добавление всех извлеченных встреч в Календарь Google для этого пользователя. |
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 и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 2025-07-25 UTC."],[],[],null,["# Method: users.messages.import\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nImports 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.\n\n### HTTP request\n\n- Upload URI, for media upload requests: \n `POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import`\n- Metadata URI, for metadata-only requests: \n `POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------------------------|\n| `userId` | `string` The user's email address. The special value `me` can be used to indicate the authenticated user. |\n\n### Query parameters\n\n| Parameters ||\n|----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `internalDateSource` | `enum (`[InternalDateSource](/workspace/gmail/api/reference/rest/v1/InternalDateSource)`)` Source for Gmail's internal date of the message. |\n| `neverMarkSpam` | `boolean` Ignore the Gmail spam classifier decision and never mark this email as SPAM in the mailbox. |\n| `processForCalendar` | `boolean` Process calendar invites in the email and add any extracted meetings to the Google Calendar for this user. |\n| `deleted` | `boolean` Mark the email as permanently deleted (not TRASH) and only visible in [Google Vault](http://support.google.com/vault/) to a Vault administrator. Only used for Google Workspace accounts. |\n\n### Request body\n\nThe request body contains an instance of [Message](/workspace/gmail/api/reference/rest/v1/users.messages#Message).\n\n### Response body\n\nIf successful, the response body contains an instance of [Message](/workspace/gmail/api/reference/rest/v1/users.messages#Message).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://mail.google.com/`\n- `\n https://www.googleapis.com/auth/gmail.modify`\n- `\n https://www.googleapis.com/auth/gmail.insert`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]