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

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