نمای کلی Drive Labels API

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

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

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

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

در زیر فهرستی از اصطلاحات رایج مورداستفاده در «میانای برنامه‌سازی کاربردی برچسب‌های Drive» آمده است:

برچسب

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

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

‫۲ سبک برچسب وجود دارد:

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

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

‫Drive رنگ گزینه انتخاب‌شده را برای هر فایل نمایش می‌دهد تا کاربران وضعیت یا طبقه‌بندی فایل را به‌وضوح درک کنند. برای مثال، گزینه «محرمانه» برای برچسب نشان‌دار «حساسیت» ممکن است به رنگ قرمز نمایش داده شود. فقط یک فیلد نشان‌دار در برچسب معینی می‌توانید داشته باشید، اما می‌توانید چندین برچسب نشان‌دار داشته باشید.

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

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

نمودار برچسب نشان‌دار.
شکل ۱. برچسب نشان‌دار
نمودار برچسب استاندارد.
شکل ۲. برچسب استاندارد
فیلد

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

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

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

نوع برچسب

همه برچسب‌ها شامل LabelType هستند. ‫۲ نوع برچسب وجود دارد:

سرپرست

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

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

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

    • مورد Drive: ‏ EDITOR
    • برچسب: APPLIER

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

    • مورد Drive: ‏ READER
    • برچسب: READER
هم‌رسانی‌شده

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

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

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

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

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

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

نسخه اصلاح‌شده برچسب

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

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