Method: users.messages.insert
Langsung menyisipkan pesan hanya ke dalam kotak surat pengguna ini yang mirip dengan IMAP APPEND, mengabaikan sebagian besar pemindaian dan klasifikasi. Tidak mengirim pesan.
Permintaan HTTP
- URI Upload, untuk permintaan upload media:
POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages
- URI Metadata, untuk permintaan khusus metadata:
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter |
userId |
string
Alamat email pengguna. Nilai khusus me dapat digunakan untuk menunjukkan pengguna yang diautentikasi.
|
Parameter kueri
| Parameter |
internalDateSource |
enum (InternalDateSource)
Sumber untuk tanggal internal Gmail pesan.
|
deleted |
boolean
Menandai email sebagai dihapus secara permanen (bukan TRASH) dan hanya terlihat di Google Vault kepada administrator Vault. Hanya digunakan untuk akun Google Workspace.
|
Isi permintaan
Isi permintaan memuat instance Message.
Isi respons
Jika berhasil, isi respons akan berisi instance Message.
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.insert
Untuk informasi selengkapnya, lihat Panduan otorisasi.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-09-05 UTC.
[null,null,["Terakhir diperbarui pada 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"]]
