Method: files.modifyLabels

Bir dosyaya uygulanan etiket grubunu değiştirir. Eklenen veya değiştirilen etiketlerin listesini döndürür.

HTTP isteği

POST https://www.googleapis.com/drive/v2/files/{fileId}/modifyLabels

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

Yol parametreleri

Parametreler
fileId

string

Etiketlerin ait olduğu dosyanın kimliği.

İstek içeriği

İstek metni, ModifyLabelsRequest öğesinin bir örneğini içerir.

Yanıt gövdesi

files.modifyLabels isteğine verilen yanıt. Bu liste yalnızca istekle eklenen veya güncellenen etiketleri içerir.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "modifiedLabels": [
    {
      object (Label)
    }
  ],
  "kind": string
}
Alanlar
modifiedLabels[]

object (Label)

İstekle eklenen veya güncellenen etiketlerin listesi.
kind

string

Bu her zaman drive#modifyLabelsResponse

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata

Bazı kapsamlar kısıtlıdır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi gerekir. Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.

ModifyLabelsRequest

Bir dosyanın etiket grubunu değiştirme isteği. Bu istek, tümü atomik olarak başarılı olacak veya başarısız olacak birçok değişiklik içerebilir.

JSON gösterimi 
{
  "labelModifications": [
    {
      object (LabelModification)
    }
  ],
  "kind": string
}
Alanlar
labelModifications[]

object (LabelModification)

Dosyadaki etiketlere uygulanacak değişikliklerin listesi.
kind

string

Bu değer her zaman drive#modifyLabelsRequest olur.

LabelModification

Dosyadaki bir etikette yapılan değişiklik. LabelModification, bir dosyaya etiket uygulamak, dosyada mevcut bir etiketi güncellemek veya dosyada bir etiketi kaldırmak için kullanılabilir.

JSON gösterimi 
{
  "labelId": string,
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "removeLabel": boolean,
  "kind": string
}
Alanlar
labelId

string

Değiştirilecek etiketin kimliği.
fieldModifications[]

object (FieldModification)

Bu etiketin alanlarında yapılan değişikliklerin listesi.
removeLabel

boolean

Doğru ise etiket dosyadan kaldırılır.
kind

string

Bu değer her zaman drive#labelModification olur.

FieldModification

Bir etiketin alanında yapılan bir değişiklik.

JSON gösterimi 
{
  "fieldId": string,
  "kind": string,
  "setDateValues": [
    string
  ],
  "setTextValues": [
    string
  ],
  "setSelectionValues": [
    string
  ],
  "setIntegerValues": [
    string
  ],
  "setUserValues": [
    string
  ],
  "unsetValues": boolean
}
Alanlar
fieldId

string

Değiştirilecek alanın kimliği.
kind

string

Bu değer her zaman drive#labelFieldModification olur.
setDateValues[]

string

date alanının değerini bu yeni değerlerle değiştirir. Dize, RFC 3339 tam tarih biçiminde (YYYY-AA-GG) olmalıdır.
setTextValues[]

string

Bir text alanının değerini ayarlar.
setSelectionValues[]

string

selection alanını bu yeni değerlerle değiştirir.
setIntegerValues[]

string (int64 format)

integer alanının değerini bu yeni değerlerle değiştirir.
setUserValues[]

string

user alanını bu yeni değerlerle değiştirir. Değerler geçerli e-posta adresleri olmalıdır.
unsetValues

boolean

Bu alanın değerlerini sıfırlar.