Method: users.messages.import
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Importa uma mensagem apenas para a caixa de entrada desse usuário, com a classificação e a verificação de entrega de e-mail padrão, semelhante à recepção por SMTP. Esse método não realiza verificações SPF. Por isso, ele pode não funcionar para algumas mensagens de spam, como aquelas que tentam realizar spoofing de domínio. Esse método não envia uma mensagem.
Solicitação HTTP
- URI de upload, para solicitações de upload de mídia:
POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import
- URI de metadados, para solicitações somente de metadados:
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros |
userId |
string
O endereço de e-mail do usuário. O valor especial me pode ser usado para indicar o usuário autenticado.
|
Parâmetros de consulta
Parâmetros |
internalDateSource |
enum (InternalDateSource )
Origem da data interna da mensagem do Gmail.
|
neverMarkSpam |
boolean
Ignorar a decisão do classificador de spam do Gmail e nunca marcar esse e-mail como SPAM na caixa de entrada.
|
processForCalendar |
boolean
Processe os convites da Agenda no e-mail e adicione as reuniões extraídas ao Google Agenda para esse usuário.
|
deleted |
boolean
Marcar o e-mail como excluído permanentemente (não LIXO) e visível apenas no Google Vault para um administrador do Vault. Usado apenas para contas do Google Workspace.
|
Corpo da solicitação
O corpo da solicitação contém uma instância de Message
.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Message
.
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.insert
Para mais informações, consulte o guia de autorização.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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)."]]