- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- ModifyLabelsRequest
- LabelModification
- FieldModification
- Deneyin.
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/v3/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.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 ( |
Alanlar | |
---|---|
modifiedLabels[] |
İstek tarafından eklenen veya güncellenen etiketlerin listesi. |
kind |
Bu her zaman drive#modifyTaggingResponse şeklindedir |
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 ( |
Alanlar | |
---|---|
labelModifications[] |
Dosyadaki etiketlere uygulanacak değişikliklerin listesi. |
kind |
Bu her zaman drive#modifyTaggingRequest şeklindedir. |
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 ( |
Alanlar | |
---|---|
labelId |
Değiştirilecek etiketin kimliği. |
fieldModifications[] |
Bu etiketin alanlarında yapılan değişikliklerin listesi. |
removeLabel |
Değer true ise etiket dosyadan kaldırılır. |
kind |
Bu her zaman drive#labelModification'dır. |
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 |
Değiştirilecek alanın kimliği. |
kind |
Bu her zaman drive#labelFieldModification'dır. |
setDateValues[] |
Bir |
setTextValues[] |
|
setSelectionValues[] |
Bir |
setIntegerValues[] |
Bir |
setUserValues[] |
Bir |
unsetValues |
Bu alan için değerleri ayarlar. |