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.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-09-05 (UTC).
[null,null,["Zuletzt aktualisiert: 2024-09-05 (UTC)."],[[["Directly inserts a message into the user's mailbox, similar to `IMAP APPEND`, bypassing most scanning and classification."],["Supports two types of requests: uploading media content (`POST /upload/...`) and sending metadata only (`POST /...`)."],["Requires providing the user's email address (`userId`) as a path parameter and offers optional query parameters to control internal date source and deletion behavior."],["The request and response bodies both utilize the `Message` resource for structuring email data."],["To authorize, you'll need one of the specified OAuth scopes related to Gmail access and modification."]]],["This content outlines the process for directly inserting a message into a user's Gmail mailbox. Key actions include using `POST` requests to either an upload URI (`/upload/gmail/v1/users/{userId}/messages`) or a metadata URI (`/gmail/v1/users/{userId}/messages`). The `userId` path parameter identifies the user, and query parameters like `internalDateSource` and `deleted` provide further message properties. A `Message` instance is sent in the request and returned in the response. Authentication requires specific OAuth scopes.\n"]]
