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.modifyEtiketler isteğinin 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

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 gerekir. Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.

ModifyLabelsRequest

Dosyadaki etiket grubunu değiştirme isteği. Bu istek, tamamı başarılı olacak ya da hiçbiri atomik olarak 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.

LabelModification

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

True (doğru) ise etiket dosyadan kaldırılır.

kind

string

Bu her zaman drive#labelModification.

FieldModification

Etiket 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 her zaman drive#labelFieldModification.

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.

unsetValues

boolean

Bu alanın değerlerini kaldırır.