Method: files.modifyLabels

Bir dosyaya uygulanan etiketler kümesini 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, yalnızca istek tarafından 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 olur.

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ıtlanmıştır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi yapılması gerekir. Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

ModifyLabelsRequest

Bir dosyadaki etiketler grubunu değiştirme isteği. Bu istek, atomik olarak ya tamamen başarılı olacak ya da tamamen 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 her zaman drive#modifyLabelsRequest olur.

LabelModification

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

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

object (FieldModification)

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

labelId

string

Değiştirilecek etiketin kimliği.

removeLabel

boolean

Doğruysa etiket dosyadan kaldırılır.

kind

string

Bu her zaman drive#labelModification olur.

FieldModification

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

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

string

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

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.

fieldId

string

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

kind

string

Bu her zaman drive#labelFieldModification olur.

unsetValues

boolean

Bu alanın değerlerini ayarlanmamış hale getirir.