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
{
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "labelId": string,
  "removeLabel": boolean,
  "kind": string
}
الحقول
fieldModifications[]

object (FieldModification)

قائمة التعديلات على حقول هذا التصنيف

labelId

string

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

removeLabel

boolean

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

kind

string

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

FieldModification

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

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

string

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

setTextValues[]

string

تضبط هذه السمة قيمة حقل text.

setSelectionValues[]

string

يستبدل حقل selection بهذه القيم الجديدة.

setIntegerValues[]

string (int64 format)

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

setUserValues[]

string

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

fieldId

string

رقم تعريف الحقل المطلوب تعديله

kind

string

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

unsetValues

boolean

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