Method: users.messages.import

Importiert eine Nachricht nur in das Postfach dieses Nutzers. E-Mail-Zustellung wird standardmäßig gescannt und klassifiziert, ähnlich wie beim Empfang über SMTP. Bei dieser Methode werden keine SPF-Prüfungen durchgeführt. Sie kann daher bei einigen Spamnachrichten nicht funktionieren, z. B. bei solchen, die versuchen, Domain-Spoofing durchzuführen. Mit dieser Methode wird keine Nachricht gesendet.

HTTP-Anfrage

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

Abfrageparameter

Parameter
internalDateSource

enum (InternalDateSource)

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

neverMarkSpam

boolean

Sie ignorieren die Entscheidung des Gmail-Spam-Klassifikators und markieren diese E-Mail nie als Spam im Postfach.

processForCalendar

boolean

Verarbeiten Sie Kalendereinladungen in der E-Mail und fügen Sie dem Google Kalender alle extrahierten Besprechungen für diesen Nutzer hinzu.

deleted

boolean

Markieren Sie die E-Mail als endgültig gelöscht (nicht als TRASH) und ist 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.