Method: users.messages.insert

Fügt eine Nachricht ähnlich wie IMAP APPEND direkt nur in das Postfach dieses Nutzers ein. Dadurch werden die meisten Scans und Klassifizierungen umgangen. Es wird keine Nachricht gesendet.

HTTP-Anfrage

  • Upload-URI für Medien-Uploadanfragen:
    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. 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.

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.