Method: users.messages.modify

Mengubah label dan nilai Label Klasifikasi pada pesan yang ditentukan. Untuk administrator yang mengubah pesan bagi pengguna di organisasi mereka, permintaan memerlukan otorisasi dengan akun layanan yang memiliki otoritas delegasi di seluruh domain untuk meniru pengguna dengan cakupan https://www.googleapis.com/auth/gmail.modify.restricted.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
userId

string

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

string

ID pesan yang akan diubah.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ],
  "addClassificationLabels": [
    {
      object (ClassificationLabelValue)
    }
  ],
  "removeClassificationLabelIds": [
    string
  ]
}
Kolom
addLabelIds[]

string

Daftar ID label yang akan ditambahkan ke pesan ini. Anda dapat menambahkan hingga 100 label dengan setiap pembaruan.
removeLabelIds[]

string

Daftar ID label yang akan dihapus dari pesan ini. Anda dapat menghapus hingga 100 label dengan setiap pembaruan.
addClassificationLabels[]

object (ClassificationLabelValue)

Daftar nilai label klasifikasi yang akan ditambahkan. Jika Label Klasifikasi dengan ID label yang sama sudah diterapkan ke pesan, kolom dengan ID kolom yang ada akan diperbarui dan kolom dengan ID kolom baru akan ditambahkan. Ada batas 20 nilai Label Klasifikasi per permintaan. Jika pesan sudah diklasifikasikan dan jumlah total akhir nilai Label Klasifikasi melebihi jumlah maksimum nilai Label Klasifikasi yang diizinkan per pesan, modifikasi akan gagal.
removeClassificationLabelIds[]

string

Daftar nilai Label Klasifikasi yang akan dihapus dari pesan ini.

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
  • https://www.googleapis.com/auth/gmail.modify.restricted

Untuk mengetahui informasi selengkapnya, lihat panduan Otorisasi.