Method: users.messages.batchModify

Belirtilen iletilerdeki etiketleri ve sınıflandırma etiketi değerlerini değiştirir. Kuruluşlarındaki kullanıcılar için iletileri değiştiren yöneticilerin istekleri, https://www.googleapis.com/auth/gmail.modify.restricted kapsamıyla kullanıcıların kimliğine bürünmek için alan genelinde yetki devri yetkisine sahip bir hizmet hesabıyla yetkilendirme gerektirir.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
userId

string

Kullanıcının e-posta adresi. Kimliği doğrulanmış kullanıcıyı belirtmek için me özel değeri kullanılabilir.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "ids": [
    string
  ],
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ],
  "addClassificationLabels": [
    {
      object (ClassificationLabelValue)
    }
  ],
  "removeClassificationLabelIds": [
    string
  ]
}
Alanlar
ids[]

string

Değiştirilecek iletilerin kimlikleri. İstek başına 1.000 kimlik sınırı vardır.
addLabelIds[]

string

İletilere eklenecek etiket kimliklerinin listesi.
removeLabelIds[]

string

İletilerden kaldırılacak etiket kimliklerinin listesi.
addClassificationLabels[]

object (ClassificationLabelValue)

Eklenecek sınıflandırma etiketi değerlerinin listesi. Aynı etiket kimliğine sahip bir sınıflandırma etiketi iletiye zaten uygulanmışsa mevcut alan kimliklerine sahip alanlar güncellenir ve yeni alan kimliklerine sahip alanlar eklenir. İstek başına 20 sınıflandırma etiketi değeri sınırı vardır. İleti zaten sınıflandırılmışsa ve nihai toplam Sınıflandırma Etiketi değeri sayısı, ileti başına izin verilen maksimum Sınıflandırma Etiketi değeri sayısını aşıyorsa değişiklik başarısız olur.
removeClassificationLabelIds[]

string

İletilerden kaldırılacak sınıflandırma etiketi değerlerinin listesi.

Yanıt metni

Başarılı olursa yanıt gövdesi boş olur.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.