Method: users.messages.modify

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

HTTP isteği

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

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.
id

string

Değiştirilecek iletinin kimliği.

İstek metni

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

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

string

Bu iletiye eklenecek etiketlerin kimliklerinin listesi. Her güncellemede en fazla 100 etiket ekleyebilirsiniz.
removeLabelIds[]

string

Bu iletiden kaldırılacak etiketlerin kimliklerinin listesi. Her güncellemede en fazla 100 etiket kaldırabilirsiniz.
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

Bu iletiden kaldırılacak sınıflandırma etiketi değerlerinin listesi.

Yanıt metni

Başarılıysa yanıt metni, Message öğesinin bir örneğini içerir.

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.