Method: users.messages.import

Importa uma mensagem apenas para a caixa de correio deste usuário, com verificação e classificação de entrega de e-mail padrão semelhantes ao recebimento por SMTP. Esse método não realiza verificações de SPF e, portanto, pode não funcionar para algumas mensagens de spam, como as que tentam fazer spoofing de domínio. Esse método não envia uma mensagem. O tamanho máximo da mensagem é de 150 MB.

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 no Gmail.

neverMarkSpam

boolean

Ignorar a decisão do classificador de spam do Gmail e nunca marcar esse e-mail como SPAM na caixa de correio.

processForCalendar

boolean

Processar convites da Agenda no e-mail e adicionar as reuniões extraídas ao Google Agenda do usuário.

deleted

boolean

Marque o e-mail como excluído permanentemente (não LIXEIRA) 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 OAuth 2.0 Overview.