Method: files.modifyLabels

Bir dosyaya uygulanan etiketler kümesini değiştirir. Daha fazla bilgi için Dosyada etiket alanı ayarlama başlıklı makaleyi inceleyin.

Eklenen veya değiştirilen etiketlerin listesini döndürür.

HTTP isteği

POST https://www.googleapis.com/drive/v3/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 yanıt verme 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 tümü başarılı olacak veya tümü 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, dosyada mevcut bir etiketi güncellemek veya dosyadan etiket 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.