Method: users.messages.insert

Insere diretamente uma mensagem apenas na caixa de e-mails deste usuário, semelhante a IMAP APPEND, ignorando a maioria das verificações e classificações. 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
  • URI de metadados, para solicitações somente de metadados:
    POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages

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)

Fonte da data interna da mensagem no Gmail.

deleted

boolean

Marcar o e-mail como excluído permanentemente (não na LIXE) 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 de 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.