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

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

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

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

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

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

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

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

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

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

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

پایتون

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

Node.js

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 استفاده کنید.

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

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

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

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

پایتون

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

Node.js

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 برچسب را روی فایل ها مشاهده و اعمال کنند.

یک برچسب را حذف کنید

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

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

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

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

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

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

پایتون

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

Node.js

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 دارد و شناسه بازبینی برچسب افزایش یافته است. برچسب را نمی توان اعمال کرد و برچسب های حذف شده در نهایت پاک می شوند. برای اطلاعات بیشتر، چرخه عمر برچسب را ببینید.