Method: users.messages.import

Importiert eine Nachricht nur in das Postfach dieses Nutzers. Die Nachricht wird wie bei einem Empfang über SMTP gescannt und klassifiziert. Bei dieser Methode werden keine SPF-Prüfungen durchgeführt. Sie funktioniert daher möglicherweise nicht bei einigen Spam-Nachrichten, z. B. bei Nachrichten, mit denen versucht wird, Domain-Spoofing durchzuführen. Mit dieser Methode wird keine Nachricht gesendet. Die maximale Größe der Nachricht beträgt 150 MB.

HTTP-Anfrage

  • Upload-URI für Media-Uploadanfragen:
    POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import
  • Metadaten-URI für Anfragen mit ausschließlich Metadaten:
    POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
userId

string

Die E-Mail-Adresse des Nutzers. Mit dem speziellen Wert me kann der authentifizierte Nutzer angegeben werden.

Suchparameter

Parameter
internalDateSource

enum (InternalDateSource)

Quelle für das interne Datum der Nachricht in Gmail.
neverMarkSpam

boolean

Ignorieren Sie die Entscheidung des Gmail-Spamfilters und markieren Sie diese E-Mail im Postfach niemals als SPAM.
processForCalendar

boolean

Verarbeite Kalendereinladungen in der E-Mail und füge alle extrahierten Besprechungen dem Google-Kalender für diesen Nutzer hinzu.
deleted

boolean

Markieren Sie die E‑Mail als endgültig gelöscht (nicht als „Papierkorb“) und nur für einen Vault-Administrator in Google Vault sichtbar. Wird nur für Google Workspace-Konten verwendet.

Anfragetext

Der Anfragetext enthält eine Instanz von Message.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Message.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.