Method: users.messages.insert

Fügt eine Nachricht direkt in das Postfach dieses Nutzers ein, ähnlich wie IMAP APPEND. Dabei werden die meisten Scan- und Klassifizierungsprozesse umgangen. Es wird keine Nachricht gesendet.

HTTP-Anfrage

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

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.
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.