Method: users.messages.insert

Die Nachricht wird nur im Postfach dieses Nutzers angelegt, ähnlich wie bei IMAP APPEND. Die meisten Scans und Klassifizierungen werden dabei umgangen. Es 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
  • 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 Wert me kann der authentifizierte Nutzer angegeben werden.

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