Method: users.messages.modify

Memodifikasi label pada pesan yang ditentukan.

Permintaan HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}/modify

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
userId

string

Alamat email pengguna. Nilai khusus me dapat digunakan untuk menunjukkan pengguna yang terautentikasi.

id

string

ID pesan yang akan diubah.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ]
}
Kolom
addLabelIds[]

string

Daftar ID label untuk ditambahkan ke pesan ini. Anda dapat menambahkan hingga 100 label dengan setiap update.

removeLabelIds[]

string

ID daftar label yang akan dihapus dari pesan ini. Anda dapat menghapus hingga 100 label dengan setiap update.

Isi respons

Jika berhasil, isi respons memuat instance Message.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.