- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- ModifyLabelsRequest
- LabelModification
- FieldModification
- Deneyin.
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 |
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 ( |
Alanlar | |
---|---|
modifiedLabels[] |
İstekle eklenen veya güncellenen etiketlerin listesi. |
kind |
Bu her zaman |
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 ( |
Alanlar | |
---|---|
labelModifications[] |
Dosyadaki etiketlere uygulanacak değişikliklerin listesi. |
kind |
Bu her zaman |
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 ( |
Alanlar | |
---|---|
fieldModifications[] |
Bu etiketin alanlarında yapılan değişikliklerin listesi. |
labelId |
Değiştirilecek etiketin kimliği. |
removeLabel |
Doğruysa etiket dosyadan kaldırılır. |
kind |
Bu her zaman |
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[] |
|
setTextValues[] |
Bir |
setSelectionValues[] |
|
setIntegerValues[] |
|
setUserValues[] |
|
fieldId |
Değiştirilecek alanın kimliği. |
kind |
Bu her zaman |
unsetValues |
Bu alanın değerlerini ayarlanmamış hale getirir. |