Method: users.messages.import

Importa un messaggio solo nella casella di posta di questo utente, con una scansione e una classificazione del recapito della posta standard simili alla ricezione tramite SMTP. Questo metodo non esegue i controlli SPF, quindi potrebbe non funzionare per alcuni messaggi di spam, come quelli che tentano di eseguire lo spoofing del dominio. Questo metodo non invia messaggi.

Richiesta HTTP

  • URI di caricamento, per le richieste di caricamento di contenuti multimediali:
    POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import
  • URI metadati, per richieste di soli metadati:
    POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
userId

string

L'indirizzo email dell'utente. È possibile utilizzare il valore speciale me per indicare l'utente autenticato.

Parametri di ricerca

Parametri
internalDateSource

enum (InternalDateSource)

Origine della data interna di Gmail del messaggio.

neverMarkSpam

boolean

Ignorare la decisione presa dal classificatore di spam in Gmail e non contrassegnare mai questa email come spam nella casella di posta.

processForCalendar

boolean

Elabora gli inviti del calendario nell'email e aggiungi a Google Calendar le riunioni estratte per questo utente.

deleted

boolean

Contrassegna l'email come eliminata definitivamente (non TRASH) e visibile solo in Google Vault a un amministratore di Vault. Utilizzato solo per gli account Google Workspace.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Message.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Message.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.insert

Per ulteriori informazioni, consulta la Guida alle autorizzazioni.