- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- ModifyLabelsRequest
- LabelModification
- FieldModification
- جرِّبه الآن
تعديل مجموعة التصنيفات المطبَّقة على ملف تعرض هذه الطريقة قائمة بالتصنيفات التي تمت إضافتها أو تعديلها.
طلب HTTP
POST https://www.googleapis.com/drive/v2/files/{fileId}/modifyLabels
يستخدِم عنوان URL بنية تحويل الترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
fileId |
رقم تعريف الملف الذي تنتمي إليه التصنيفات |
نص الطلب
يحتوي نص الطلب على مثال ModifyLabelsRequest
.
نص الاستجابة
ردّ على طلب files.modifyLabels يحتوي هذا الحقل على التصنيفات التي تمت إضافتها أو تعديلها من خلال الطلب فقط.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"modifiedLabels": [
{
object ( |
الحقول | |
---|---|
modifiedLabels[] |
قائمة التصنيفات التي تمت إضافتها أو تعديلها من خلال الطلب. |
kind |
هذا هو دائمًا |
نطاقات الأذونات
يجب توفير أحد نطاقات 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 |
يكون هذا الخيار |
LabelModification
تعديل على تصنيف في ملف يمكن استخدام LabelModification لتطبيق تصنيف على ملف أو تعديل تصنيف حالي على ملف أو إزالة تصنيف من ملف.
تمثيل JSON |
---|
{
"fieldModifications": [
{
object ( |
الحقول | |
---|---|
fieldModifications[] |
قائمة التعديلات على حقول هذا التصنيف |
labelId |
رقم تعريف التصنيف المطلوب تعديله. |
removeLabel |
إذا كانت القيمة هي true، ستتم إزالة التصنيف من الملف. |
kind |
يكون هذا الخيار |
FieldModification
تعديل على حقل تصنيف
تمثيل JSON |
---|
{ "setDateValues": [ string ], "setTextValues": [ string ], "setSelectionValues": [ string ], "setIntegerValues": [ string ], "setUserValues": [ string ], "fieldId": string, "kind": string, "unsetValues": boolean } |
الحقول | |
---|---|
setDateValues[] |
يستبدل قيمة الحقل |
setTextValues[] |
تضبط هذه السمة قيمة حقل |
setSelectionValues[] |
يستبدل حقل |
setIntegerValues[] |
يستبدل قيمة الحقل |
setUserValues[] |
يستبدل حقل |
fieldId |
رقم تعريف الحقل المطلوب تعديله |
kind |
يكون هذا الخيار |
unsetValues |
تؤدي إلى إلغاء ضبط قيم هذا الحقل. |