Method: labels.publish

انشر جميع التغييرات في المسودة على التصنيف. بعد النشر، قد لا يعود التصنيف إلى حالة المسودة. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء تصنيف ونشره.

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

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

  • لا يمكن حذف التصنيف مباشرةً. يجب إيقافه أولاً، ثم حذفه.
  • لا يمكن تغيير 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

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