Method: users.messages.import

Importiert eine Nachricht nur in das Postfach dieses Nutzers. Dabei werden E-Mails standardmäßig gescannt und klassifiziert, ähnlich wie beim Empfang über SMTP. Bei dieser Methode werden keine SPF-Prüfungen durchgeführt. Bei einigen Spamnachrichten, z. B. bei dem Versuch, Domain-Spoofing durchzuführen, funktioniert sie möglicherweise nicht. Mit dieser Methode wird keine Nachricht gesendet.

HTTP-Anfrage

  • Upload-URI für Medien-Uploadanfragen:
    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. Mit dem speziellen Wert me kann der authentifizierte Nutzer angegeben werden.

Abfrageparameter

Parameter
internalDateSource

enum (InternalDateSource)

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

boolean

Die Entscheidung für den Gmail-Spamklassifikator ignorieren und diese E-Mail im Postfach nie als Spam markieren.
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 im Papierkorb) und nur in Google Vault für einen Vault-Administrator 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.