Method: files.modifyLabels

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

طلب HTTP

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

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

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

المَعلمات
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

تكون بعض النطاقات محظورة وتتطلب تقييمًا أمنيًا من تطبيقك لاستخدامها. لمزيد من المعلومات، راجِع دليل التفويض.

ModifyLabelsRequest

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

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

object (LabelModification)

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

kind

string

يكون هذا دائمًا drive#modifylabelRequest.

LabelModification

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

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

string

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

fieldModifications[]

object (FieldModification)

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

removeLabel

boolean

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

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

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