Method: labels.disable

برچسب منتشر شده را غیرفعال کنید. برای اطلاعات بیشتر، به غیرفعال کردن، فعال کردن و حذف یک برچسب مراجعه کنید.

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

پس از غیرفعال شدن، ممکن است یک برچسب با labels.delete حذف شود.

درخواست HTTP

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

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

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

پارامترها
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

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