نمای کلی Drive Labels API

برچسب‌ها ابرداده‌هایی هستند که برای کمک به کاربران در سازمان‌دهی، یافتن و اعمال خط‌مشی روی فایل‌ها در Google Drive تعریف می‌کنید. Drive Labels API یک API RESTful است که با پیوست کردن ابرداده به فایل‌های Drive شما از فرآیندهای تجاری پشتیبانی می‌کند. کاربردهای رایج این API عبارتند از:

  • طبقه بندی محتوا برای پیروی از یک استراتژی حاکمیت اطلاعات — یک برچسب برای شناسایی محتوای حساس یا داده هایی که نیاز به رسیدگی ویژه دارند ایجاد کنید. به عنوان مثال، ممکن است یک برچسب با نشان (برچسبی با مقادیر گزینه کدگذاری شده رنگی) با عنوان "حساسیت" با مقادیر "محرمانه"، "محرمانه" و "عمومی" ایجاد کنید.

  • اعمال خط‌مشی در مورد موارد در Drive — برای مدیریت محتوای Drive در طول چرخه عمر خود، برچسب‌هایی ایجاد کنید و اطمینان حاصل کنید که به شیوه‌های ثبت سوابق سازمان شما پایبند است. به عنوان مثال، از برچسب‌ها برای مدیریت خط‌مشی از دست دادن داده (DLP) استفاده کنید که به موجب آن فایل‌های دارای برچسب «حساسیت» روی «بسیار محرمانه» نمی‌توانند در رایانه دانلود شوند.

  • فایل‌ها را انتخاب کنید و پیدا کنید — برای افزایش قابلیت جستجو در محتوای شرکت خود، به افراد سازمانتان اجازه دهید موارد را بر اساس برچسب‌ها و فیلدهایشان پیدا کنند، برچسب ایجاد کنید. برای مثال، شخصی در سازمان شما می‌تواند از گزینه‌های جستجوی Drive استفاده کند تا تمام قراردادهایی را که در انتظار امضا هستند تا تاریخ مشخصی پیدا کند.

در زیر فهرستی از اصطلاحات رایج مورد استفاده در Drive Labels API آمده است:

برچسب

فراداده ساختاریافته قرار داده شده در فایل Drive. کاربران Drive می توانند برچسب ها را اختصاص دهند و مقادیر فیلد برچسب را برای فایل ها تنظیم کنند. برچسب ها از موارد زیر تشکیل شده اند:

نام برچسب
نام منبع برچسب. شناسه برچسب بخشی از نام برچسب را تشکیل می دهد. بسته به درخواست، نام به شکل زیر است: labels/{id} یا labels/{id}@{revisionId} . برای اطلاعات بیشتر، ویرایش برچسب را در زیر ببینید.
شناسه برچسب
یک شناسه منحصر به فرد جهانی برای برچسب. شناسه بخشی از نام برچسب را تشکیل می دهد، اما بر خلاف نام، بین ویرایش ها سازگار است.

2 سبک از برچسب ها وجود دارد:

برچسب دارای نشان

برچسبی با نوع فیلد SelectionOptions که حاوی گزینه‌هایی است که می‌توانند برای نشان دادن اهمیت با رنگ کدگذاری شوند. این کار با تنظیم badgeConfig از طریق Properties of a Choice انجام می شود.

Drive رنگ گزینه انتخاب شده را برای هر فایل نمایش می دهد تا کاربران به وضوح وضعیت، طبقه بندی و غیره فایل را درک کنند. به عنوان مثال، گزینه "Top Secret" برای برچسب "Sensitivity" ممکن است به رنگ قرمز نمایش داده شود. شما می توانید هر بار فقط یک برچسب دارای نشان داشته باشید.

برچسب استاندارد

برچسبی حاوی صفر یا بیشتر از نوع فیلد s. یک برچسب استاندارد ممکن است یک عنوان برچسب مانند "Project Moonshot" داشته باشد و همه فایل های مربوط به پروژه را نشان دهد. یک برچسب استاندارد همچنین ممکن است چندین فیلد ساختاریافته داشته باشد. برای مثال، برچسبی با عنوان "قرارداد" ممکن است حاوی فیلدهای "شرکت"، "تاریخ سررسید"، "وضعیت" و "امضاکنندگان" باشد. هر فیلد از نوع خاصی است (متن، تاریخ، انتخاب یا کاربر).

نمودار برچسب دار.
شکل 1. برچسب نشان
نمودار برچسب استاندارد
شکل 2. برچسب استاندارد
رشته

یک جزء تایپ شده و قابل تنظیم از یک برچسب. یک برچسب می تواند صفر یا چند فیلد مرتبط با آن داشته باشد.

نوع میدان
نوع داده مقدار مربوط به فیلد . قابل تنظیم به عنوان متن، عدد صحیح، تاریخ، کاربر یا انتخاب. اگر فیلد را با ListOptions پیکربندی کنید، می توانید فیلدهای کاربر و انتخاب را با چندین مقدار تنظیم کنید. نوع انتخاب شده هم بر مقادیر معتبر قابل اعمال برای موارد Drive و هم بر گزینه های جستجوی موجود تأثیر می گذارد.
انتخاب

یکی از چندین گزینه ای که کاربر می تواند از میان یک فیلد SelectionOptions انتخاب کند.

نوع برچسب

همه برچسب ها دارای یک LabelType هستند. 2 نوع برچسب وجود دارد:

مدیر

برای ایجاد و ویرایش برچسب‌های متعلق به سرپرست، باید یک سرپرست حساب با امتیاز مدیریت برچسب‌ها باشید.

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

  • اصلاح - برای اینکه کاربر بتواند فراداده مورد Drive مربوط به یک برچسب مشخص را تغییر دهد، کاربر باید سطوح مجوز مناسب را داشته باشد:

    • مورد درایو: EDITOR
    • برچسب: APPLIER

  • خواندن — برای اینکه کاربر بتواند فراداده مورد Drive مربوط به یک برچسب مشخص را بخواند یا جستجو کند، کاربر باید سطوح مجوز مناسب را داشته باشد:

    • مورد درایو: READER
    • برچسب: READER
به اشتراک گذاشته شده است

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

طبقه بندی برچسب

فیلدهای برچسب پیکربندی شده کنونی برای استفاده در فایل‌های Drive در دسترس کاربران است. همچنین به عنوان طرح برچسب شناخته می شود.

نمونه طبقه بندی برچسب:

  • حساسیت - قرمز، نارنجی، زرد، سبز
  • وضعیت - شروع نشده، پیش نویس، در حال بررسی، نهایی
  • نوع محتوا - قرارداد، سند طراحی، موکاپ
  • بخش - بازاریابی، مالی، منابع انسانی، فروش
چرخه عمر برچسب

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

بازبینی برچسب

نمونه ای از برچسب. هر زمان که یک برچسب ایجاد، به‌روزرسانی، منتشر یا منسوخ شود، بازبینی برچسب افزایش می‌یابد.

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