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 تنظیم کنید. سرور قبل از اجازه دسترسی، تأیید می‌کند که کاربر یک سرپرست برای Label است.

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

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