Method: files.modifyLabels

تعديل مجموعة التصنيفات المطبَّقة على ملف تعرِض هذه الدالة قائمة بالتصنيفات التي تمت إضافتها أو تعديلها.

طلب HTTP

POST https://www.googleapis.com/drive/v2/files/{fileId}/modifyLabels

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
fileId

string

رقم تعريف الملف الذي تنتمي إليه التصنيفات

نص الطلب

يحتوي نص الطلب على مثال ModifyLabelsRequest.

نص الاستجابة

استجابة لطلب files.modifyLabels لا يحتوي هذا التقرير إلا على التصنيفات التي تمت إضافتها أو تعديلها من خلال الطلب.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "modifiedLabels": [
    {
      object (Label)
    }
  ],
  "kind": string
}
الحقول
modifiedLabels[]

object (Label)

قائمة التصنيفات التي تمت إضافتها أو تعديلها من خلال الطلب
kind

string

هذا الإعداد دائمًا هو drive#modifyLabelsResponse

نطاقات التفويض

يتطلب أحد نطاقات 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 (LabelModification)
    }
  ],
  "kind": string
}
الحقول
labelModifications[]

object (LabelModification)

قائمة التعديلات المطلوب تطبيقها على التصنيفات في الملف
kind

string

يكون هذا الخيار دائمًا drive#modifyLabelsRequest.

LabelModification

تعديل على تصنيف ملف يمكن استخدام LabelModification لتطبيق تصنيف على ملف أو تعديل تصنيف حالي في ملف أو إزالة تصنيف من ملف.

تمثيل JSON 
{
  "labelId": string,
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "removeLabel": boolean,
  "kind": string
}
الحقول
labelId

string

رقم تعريف التصنيف المطلوب تعديله.
fieldModifications[]

object (FieldModification)

قائمة التعديلات التي تم إجراؤها على حقول هذا التصنيف
removeLabel

boolean

إذا كانت القيمة هي true، ستتم إزالة التصنيف من الملف.
kind

string

يكون هذا الخيار دائمًا drive#labelModification.

FieldModification

تعديل على حقل تصنيف

تمثيل JSON 
{
  "fieldId": string,
  "kind": string,
  "setDateValues": [
    string
  ],
  "setTextValues": [
    string
  ],
  "setSelectionValues": [
    string
  ],
  "setIntegerValues": [
    string
  ],
  "setUserValues": [
    string
  ],
  "unsetValues": boolean
}
الحقول
fieldId

string

رقم تعريف الحقل الذي سيتم تعديله
kind

string

يكون هذا الخيار دائمًا drive#labelFieldModification.
setDateValues[]

string

تستبدِل هذه الدالة قيمة حقل date بهذه القيم الجديدة. يجب أن تكون السلسلة بتنسيق التاريخ الكامل RFC 3339: ‏ YYYY-MM-DD.
setTextValues[]

string

لضبط قيمة حقل text
setSelectionValues[]

string

استبدال حقل selection بهذه القيم الجديدة
setIntegerValues[]

string (int64 format)

تستبدِل هذه الدالة قيمة حقل integer بهذه القيم الجديدة.
setUserValues[]

string

استبدال حقل user بهذه القيم الجديدة يجب أن تكون القيم عناوين بريد إلكتروني صالحة.
unsetValues

boolean

تؤدي هذه الدالة إلى إلغاء ضبط قيم هذا الحقل.