غیرفعال کردن، فعال کردن و حذف یک برچسب

این سند نحوه انجام این وظایف مربوط به برچسب‌ها را شرح می‌دهد:

• غیرفعال کردن برچسب
• فعال کردن برچسب
• حذف یک برچسب

غیرفعال کردن برچسب

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

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

برای غیرفعال کردن یک برچسب منتشر شده، از متد disable در منبع labels استفاده کنید.

همچنین باید مشخص کنید:

• یک منبع labels که نشان دهنده برچسب است. این منبع شامل یک name و یک id است که یک شناسه منحصر به فرد جهانی برای برچسب است.

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

نمونه کد زیر نحوه استفاده id برچسب برای غیرفعال کردن برچسب صحیح را نشان می‌دهد:

پایتون

service.labels().disable(
    name='labels/ID',
    body={
        'useAdminAccess': True
    }
).execute()

نود جی اس

service.labels.disable({
  name: 'labels/ID',
  requestBody: {
    useAdminAccess: true
  }
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

برای غیرفعال کردن، ID برچسب را با شناسه برچسب جایگزین کنید.

این برچسب دارای State DISABLED است و شناسه‌ی بازبینی برچسب افزایش می‌یابد. کاربران می‌توانند این برچسب را از طریق Drive Labels API اعمال کنند. با این حال، یک برچسب غیرفعال در رابط کاربری نمایش داده نمی‌شود مگر اینکه فیلد showInApply از شیء DisabledPolicy پیکربندی شده باشد.

فعال کردن برچسب

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

برای فعال کردن یک برچسب غیرفعال، از متد enable در منبع labels استفاده کنید.

همچنین باید مشخص کنید:

• یک منبع labels که نشان دهنده برچسب است. این منبع شامل یک name و یک id است که یک شناسه منحصر به فرد جهانی برای برچسب است.

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

نمونه کد زیر نحوه استفاده id برچسب برای فعال کردن برچسب صحیح را نشان می‌دهد:

پایتون

service.labels().enable(
    name='labels/ID',
    body={
        'useAdminAccess': True
    }
).execute()

نود جی اس

service.labels.enable({
  name: 'labels/ID',
  requestBody: {
    useAdminAccess: true
  }
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

برای فعال کردن، ID با شناسه برچسب جایگزین کنید.

State برچسب PUBLISHED است و شناسه‌ی ویرایش برچسب افزایش می‌یابد. کاربران می‌توانند برچسب را از طریق رابط برنامه‌نویسی کاربردی Drive Labels مشاهده و به فایل‌ها اعمال کنند.

حذف یک برچسب

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

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

همچنین باید مشخص کنید:

• یک منبع labels که نشان دهنده برچسب است. این منبع شامل یک name و یک id است که یک شناسه منحصر به فرد جهانی برای برچسب است.

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

نمونه کد زیر نحوه استفاده id برچسب برای حذف برچسب صحیح را نشان می‌دهد:

پایتون

response = service.labels().delete(
    name='labels/ID',
    useAdminAccess=True
).execute()

نود جی اس

service.labels.delete({
  name: 'labels/ID',
  useAdminAccess: true
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

به جای ID شناسه برچسبی که می‌خواهید حذف کنید را قرار دهید.

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