Method: files.modifyLabels

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

طلب HTTP

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

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

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

المعلمات
fileId

string

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

نص الطلب

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

نص الاستجابة

الردّ على طلب file.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

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

تمثيل 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

لإلغاء تعيين قيم هذا الحقل.