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

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