Method: users.messages.modify

Mengubah 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 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 yang akan ditambahkan ke pesan ini. Anda dapat menambahkan hingga 100 label dalam setiap pembaruan.

removeLabelIds[]

string

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

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 informasi selengkapnya, lihat Panduan otorisasi.