Method: labels.disable

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

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

طلب HTTP

POST https://drivelabels.googleapis.com/v2beta/{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

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