Method: labels.disable

إيقاف تصنيف منشور لمزيد من المعلومات، يُرجى الاطّلاع على إيقاف تصنيف وتفعيله وحذفه.

سيؤدي إيقاف تصنيف إلى إنشاء نسخة معدَّلة جديدة تم نشرها مع إيقاف التصنيف استنادًا إلى النسخة المعدَّلة المنشورة الحالية. إذا كانت هناك مسوّدة معدَّلة، سيتم إنشاء مسوّدة معدَّلة جديدة غير مفعَّلة استنادًا إلى آخر مسوّدة معدَّلة. سيتم حذف مراجعات المسودات الأقدم.

بعد إيقاف تصنيف، يمكن حذفه باستخدام labels.delete.

طلب HTTP

POST https://drivelabels.googleapis.com/v2/{name=labels/*}:disable

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

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

المعلمات
name

string

مطلوب. اسم مورد التصنيف

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "updateMask": string,
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "disabledPolicy": {
    object (DisabledPolicy)
  },
  "languageCode": string
}
الحقول
updateMask

string (FieldMask format)

الحقول التي يجب تعديلها يجب تحديد حقل واحد على الأقل. يتم تضمين disabledPolicy الجذر تلقائيًا ويجب عدم تحديده. يمكن استخدام * واحدة كاختصار لتعديل كل حقل.
useAdminAccess

boolean

اضبط القيمة على true لاستخدام بيانات اعتماد المشرف الخاصة بالمستخدم. سيتأكّد الخادم من أنّ المستخدم هو مشرف على التصنيف قبل السماح له بالوصول إليه.
writeControl

object (WriteControl)

توفّر هذه السمة إمكانية التحكّم في طريقة تنفيذ طلبات الكتابة. يتم ضبط هذه السمة تلقائيًا على "لم يتم ضبطها"، ما يعني أنّ آخر عملية كتابة هي التي تكون الأولوية.
disabledPolicy

object (DisabledPolicy)

سياسة غير مفعَّلة للاستخدام
languageCode

string

رمز اللغة BCP-47 الذي سيتم استخدامه لتقييم تصنيفات الحقول المترجمة. في حال عدم تحديدها، سيتم استخدام القيم باللغة التلقائية التي تم ضبطها.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Label.

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

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.