Method: users.messages.insert

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Fügt eine Nachricht direkt in das Postfach dieses Nutzers ein, ähnlich wie IMAP APPEND, wodurch die meisten Scans und Klassifizierungen umgangen 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 mit 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.

Abfrageparameter

Parameter
internalDateSource

enum (InternalDateSource)

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

deleted

boolean

Sie können festlegen, dass die E-Mail als endgültig gelöscht, nicht als Papierkorb markiert wird und nur in Google Vault für einen Vault-Administrator sichtbar ist. 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 in der Übersicht zu OAuth 2.0.