- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- ModifyLabelsRequest
- LabelModification
- FieldModification (تعديل الحقل)
- جرِّبه الآن
لتعديل مجموعة التصنيفات التي تم تطبيقها على ملف. تعرض قائمة بالتصنيفات التي تمت إضافتها أو تعديلها.
طلب HTTP
POST https://www.googleapis.com/drive/v3/files/{fileId}/modifyLabels
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
fileId |
معرّف الملف الذي تنتمي إليه التصنيفات. |
نص الطلب
يحتوي نص الطلب على مثال ModifyLabelsRequest
.
نص الاستجابة
الردّ على طلب files.modifyLabel. وهي تشمل فقط التصنيفات التي تمت إضافتها أو تعديلها من خلال الطلب.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"modifiedLabels": [
{
object ( |
الحقول | |
---|---|
modifiedLabels[] |
قائمة التصنيفات التي تمت إضافتها أو تعديلها بواسطة الطلب. |
kind |
هذا هو دائمًا drive#modifylabelResponse |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.metadata
تكون بعض النطاقات محظورة وتتطلب تقييمًا أمنيًا من تطبيقك لاستخدامها. لمزيد من المعلومات، راجِع دليل التفويض.
ModifyLabelsRequest
طلب لتعديل مجموعة التصنيفات في ملف. قد يتضمن هذا الطلب العديد من التعديلات التي ستنجح جميعها أو تفشل جميعها بشكل كامل.
تمثيل JSON |
---|
{
"labelModifications": [
{
object ( |
الحقول | |
---|---|
labelModifications[] |
قائمة التعديلات المطلوب تطبيقها على التصنيفات في الملف. |
kind |
يكون هذا دائمًا drive#modifylabelRequest. |
LabelModification
تعديل تصنيف على ملف. يمكن استخدام ميزة "تعديل التصنيف" لتطبيق تصنيف على ملف أو تعديل تصنيف حالي على ملف أو إزالة تصنيف من ملف.
تمثيل JSON |
---|
{
"labelId": string,
"fieldModifications": [
{
object ( |
الحقول | |
---|---|
labelId |
رقم تعريف التصنيف المطلوب تعديله. |
fieldModifications[] |
قائمة التعديلات على حقول هذا التصنيف |
removeLabel |
إذا كانت القيمة "صحيح"، ستتم إزالة التصنيف من الملف. |
kind |
هذا هو دائمًا drive#labelModification. |
FieldModification
تعديل حقل التصنيف
تمثيل JSON |
---|
{ "fieldId": string, "kind": string, "setDateValues": [ string ], "setTextValues": [ string ], "setSelectionValues": [ string ], "setIntegerValues": [ string ], "setUserValues": [ string ], "unsetValues": boolean } |
الحقول | |
---|---|
fieldId |
رقم تعريف الحقل المطلوب تعديله. |
kind |
ويكون هذا دائمًا drive#labelFieldModification. |
setDateValues[] |
تستبدِل قيمة الحقل |
setTextValues[] |
تحدِّد قيمة الحقل |
setSelectionValues[] |
تستبدِل هذه القيم الجديدة حقل |
setIntegerValues[] |
تستبدِل قيمة الحقل |
setUserValues[] |
تستبدِل هذه القيم الجديدة حقل |
unsetValues |
يؤدي هذا الخيار إلى إلغاء ضبط قيم هذا الحقل. |