Method: users.threads.modify
Mengubah label yang diterapkan ke rangkaian pesan. Ini berlaku untuk semua pesan dalam rangkaian pesan.
Permintaan HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}/modify
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter |
userId |
string
Alamat email pengguna. Nilai khusus me dapat digunakan untuk menunjukkan pengguna terautentikasi.
|
id |
string
ID thread yang akan diubah.
|
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
| Representasi JSON |
{
"addLabelIds": [
string
],
"removeLabelIds": [
string
]
} |
| Kolom |
addLabelIds[] |
string
Daftar ID label yang akan ditambahkan ke rangkaian pesan ini. Anda dapat menambahkan hingga 100 label dalam setiap pembaruan.
|
removeLabelIds[] |
string
Daftar ID label yang akan dihapus dari rangkaian pesan ini. Anda dapat menghapus hingga 100 label dalam setiap pembaruan.
|
Isi respons
Jika berhasil, isi respons memuat instance Thread.
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
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."],[[["This method modifies the labels applied to all messages within a specific thread using the thread ID and user ID."],["The request body allows adding or removing labels by specifying their IDs, with a limit of 100 labels per update."],["Upon successful execution, the API returns a detailed representation of the updated thread, including its properties and metadata."],["Authorization requires specific OAuth scopes, such as 'https://mail.google.com/' or 'https://www.googleapis.com/auth/gmail.modify', to grant access and permissions."]]],["This describes modifying thread labels in Gmail via an HTTP POST request to `https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}/modify`. The request requires `userId` (email or `me`) and `id` (thread ID) path parameters. The request body, in JSON format, includes arrays `addLabelIds` and `removeLabelIds` for adding/removing label IDs (up to 100 each). A successful response returns a Thread instance, and authorization requires specific OAuth scopes.\n"]]
