Method: users.messages.insert

Eine Nachricht wird ähnlich wie bei IMAP APPEND direkt in das Postfach dieses Nutzers eingefügt, wobei die meisten Scan- und Klassifizierungsschritte übersprungen werden. Es 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
  • Metadaten-URI für Anfragen, die nur Metadaten enthalten:
    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. 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.
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.