Method: labels.publish

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

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

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

طلب 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

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