Method: labels.publish

همه تغییرات پیش‌نویس برچسب را منتشر کنید. پس از انتشار، برچسب ممکن است به حالت پیش‌نویس خود بازگردد. برای اطلاعات بیشتر به google.apps.drive.labels.v2.Lifecycle مراجعه کنید.

انتشار یک برچسب منجر به ویرایش جدید منتشر شده می شود. همه پیش‌نویس‌های قبلی حذف خواهند شد. ویرایش‌های منتشر شده قبلی حفظ خواهند شد، اما در صورت نیاز به صورت خودکار حذف می‌شوند.

پس از انتشار، برخی از تغییرات دیگر مجاز نیستند. به طور کلی، هر تغییری که باعث بی اعتباری یا ایجاد محدودیت‌های جدید در ابرداده‌های موجود مرتبط با برچسب شود، رد خواهد شد. به عنوان مثال، تغییرات زیر در یک برچسب پس از انتشار برچسب رد می شود: * برچسب را نمی توان مستقیماً حذف کرد. ابتدا باید غیرفعال شود، سپس حذف شود. * Field.FieldType را نمی توان تغییر داد. * تغییرات در گزینه های اعتبارسنجی فیلد نمی تواند چیزی را که قبلاً پذیرفته شده بود رد کند. * کاهش حداکثر ورودی.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
name

string

ضروری. نام منبع برچسب.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "languageCode": string
}
زمینه های
useAdminAccess

boolean

برای استفاده از اعتبارنامه مدیریت کاربر، روی true تنظیم کنید. سرور قبل از اجازه دسترسی، تأیید می‌کند که کاربر یک سرپرست برای Label است.

writeControl

object ( WriteControl )

کنترل نحوه اجرای درخواست های نوشتن را فراهم می کند. پیش‌فرض‌ها به حالت تنظیم در نمی‌آیند، به این معنی که آخرین نوشتن برنده است.

languageCode

string

کد زبان BCP-47 که برای ارزیابی برچسب‌های فیلد محلی استفاده می‌شود. هنگامی که مشخص نیست، از مقادیر در زبان پیکربندی پیش فرض استفاده می شود.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Label است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.