Method: users.messages.import

Eine Nachricht wird nur in den Posteingang dieses Nutzers importiert. Dabei werden die Nachrichten gescannt und klassifiziert, ähnlich wie beim Empfang über SMTP. Bei dieser Methode werden keine SPF-Prüfungen durchgeführt. Daher funktioniert sie möglicherweise nicht bei einigen Spam-Nachrichten, z. B. bei solchen, bei denen versucht wird, Domain-Spoofing durchzuführen. Bei dieser Methode wird keine Nachricht gesendet.

HTTP-Anfrage

  • Upload-URI für Anfragen zum Hochladen von Medien:
    POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import
  • Metadaten-URI für Anfragen, die nur Metadaten enthalten:
    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. Der spezielle Wert me kann verwendet werden, um den authentifizierten Nutzer anzugeben.

Abfrageparameter

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 niemals als SPAM im Posteingang.
processForCalendar

boolean

Kalendereinladungen in der E-Mail verarbeiten und alle extrahierten Besprechungen dem Google Kalender für diesen Nutzer hinzufügen.
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 im Leitfaden zur Autorisierung.