Method: labels.publish

انشر جميع تغييرات المسودة على التصنيف. بعد نشر "التصنيف"، قد لا يعود إلى حالة المسودة. يمكنك الاطّلاع على google.apps.drive.labels.v2.Lifecycle لمزيد من المعلومات.

سيؤدي نشر تصنيف إلى إصدار نسخة جديدة منشورة. سيتم حذف جميع مراجعات المسودة السابقة. سيتم الاحتفاظ بالمراجعات المنشورة سابقًا، ولكنّها تخضع للحذف التلقائي حسب الحاجة.

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

طلب HTTP

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

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

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

المَعلمات
name

string

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

نص الطلب

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

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

boolean

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

object (WriteControl)

توفر إمكانية التحكم في كيفية تنفيذ طلبات الكتابة. وتكون الإعدادات التلقائية بدون ضبط، ما يعني عمليات الفوز الأخيرة بالكتابة.
languageCode

string

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

نص الاستجابة

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

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

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

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