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

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

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

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

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

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

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

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

• یک منبع Label که هر برچسب را نشان می‌دهد. این شامل یک منبع Name و ID است که یک شناسه منحصر به فرد جهانی برای برچسب است.

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

این مثال از ID برای غیرفعال کردن برچسب صحیح استفاده می‌کند.

پایتون

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

نود جی اس

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

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

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

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

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

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

• یک منبع Label که هر برچسب را نشان می‌دهد. این شامل یک منبع Name و ID است که یک شناسه منحصر به فرد جهانی برای برچسب است.

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

این مثال از ID برای فعال کردن برچسب صحیح استفاده می‌کند.

پایتون

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

نود جی اس

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

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

حذف یک برچسب

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

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

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

• یک منبع Label که هر برچسب را نشان می‌دهد. این شامل یک منبع Name و ID است که یک شناسه منحصر به فرد جهانی برای برچسب است.

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

این مثال از ID برای حذف برچسب صحیح استفاده می‌کند.

پایتون

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

نود جی اس

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

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