Method: files.modifyLabels

Bir dosyaya uygulanan etiket grubunu değiştirir. Eklenen veya değiştirilen etiketlerin bir 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.modifyEtiketler 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)

İstek tarafından 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ılavuzuna göz atın.

ModifyLabelsRequest

Bir dosyadaki etiket grubunu değiştirme isteği. Bu istek, ya tümü başarılı 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

Bir dosyadaki etikette yapılan değişiklik. LabelModification; bir dosyaya etiket uygulamak, dosyadaki mevcut bir etiketi güncellemek veya dosyadaki 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

Değer true ise 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 
{
  "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 her zaman drive#labelFieldModification olur.
setDateValues[]

string

Bir 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

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

string

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

string (int64 format)

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

string

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

boolean

Bu alan için değerleri ayarlar.