Method: files.modifyLabels

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المَعلمات
fileId

string

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

نص الطلب

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

نص الاستجابة

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

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

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

object (Label)

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

string

هذا هو Drive#modifyLabelResponse دائمًا

نطاقات الأذونات

يتطلب ذلك أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata

بعض النطاقات مقيَّدة وتتطلَّب تقييم أمان لكي يستخدمها تطبيقك. لمزيد من المعلومات، اطّلِع على دليل التفويض.

طلب تعديل التصنيفات

طلب لتعديل مجموعة التصنيفات في ملف قد يحتوي هذا الطلب على العديد من التعديلات التي ستنجح جميعها أو يتعذّر تنفيذها بالكامل.

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

object (LabelModification)

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

string

هذه هي دائمًا drive#modifyLabelRequest.

تعديل التصنيف

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

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

string

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

object (FieldModification)

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

boolean

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

string

هذه دائمًا drive#labelModification.

تعديل الحقل

تعديل في حقل التصنيف.

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

string

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

string

وهذا هو دائمًا drive#labelFieldModization.
setDateValues[]

string

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

string

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

string

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

string (int64 format)

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

string

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

boolean

لإلغاء ضبط قيم هذا الحقل.