برچسبها ، فرادادههایی هستند که شما برای کمک به کاربران در سازماندهی، یافتن و اعمال سیاستها بر روی فایلهای موجود در گوگل درایو تعریف میکنید. API برچسبهای درایو یک API RESTful است که با پیوست کردن فرادادهها به فایلهای درایو شما، از فرآیندهای تجاری پشتیبانی میکند. کاربردهای رایج این API عبارتند از:
طبقهبندی محتوا برای پیروی از یک استراتژی مدیریت اطلاعات — یک برچسب برای شناسایی محتوا یا دادههای حساس که نیاز به مدیریت ویژه دارند، ایجاد کنید. به عنوان مثال، میتوانید یک برچسب نشاندار (برچسبی با مقادیر گزینههای رنگی) با عنوان "حساسیت" با مقادیر "فوق سری"، "محرمانه" و "عمومی" ایجاد کنید.
اعمال سیاست روی موارد موجود در درایو — برچسبهایی برای مدیریت محتوای درایو در طول چرخه عمر آن ایجاد کنید و مطمئن شوید که به شیوههای نگهداری سوابق سازمان شما پایبند است. به عنوان مثال، از برچسبها برای مدیریت سیاست از دست دادن دادهها (DLP) استفاده کنید که به موجب آن فایلهایی که برچسب «حساسیت» آنها روی «فوق سری» تنظیم شده است، نمیتوانند در رایانه دانلود شوند.
انتخاب و یافتن فایلها — با ایجاد برچسبها، قابلیت جستجوی محتوای شرکت خود را افزایش دهید و به افراد سازمان خود اجازه دهید موارد را بر اساس برچسبها و فیلدهای آنها پیدا کنند. به عنوان مثال، شخصی در سازمان شما میتواند از گزینههای جستجوی Drive برای یافتن تمام قراردادهایی که تا یک تاریخ خاص در انتظار امضا هستند، استفاده کند.
در زیر لیستی از اصطلاحات رایج مورد استفاده در Drive Labels API آمده است:
- برچسب
فرادادههای ساختاریافتهای که روی یک فایل Drive قرار میگیرند. کاربران Drive میتوانند برای فایلها برچسب تعیین کنند و مقادیر فیلد برچسب را تنظیم کنند. برچسبها از موارد زیر تشکیل شدهاند:
- نام برچسب
- نام منبع برچسب. شناسه برچسب بخشی از نام برچسب را تشکیل میدهد. بسته به درخواست، نام به شکل
labels/{id}یاlabels/{id}@{revisionId}است. برای اطلاعات بیشتر، به Label revision در زیر مراجعه کنید. - شناسه برچسب
- یک شناسه منحصر به فرد جهانی برای برچسب. شناسه بخشی از نام برچسب را تشکیل میدهد، اما برخلاف نام، بین نسخههای مختلف ثابت است.
دو نوع برچسب وجود دارد:
- برچسب نشاندار
برچسبی با نوع فیلد
SelectionOptionsکه شامل گزینههایی است که میتوانند برای نشان دادن اهمیت، کدگذاری رنگی شوند. این کار با تنظیمbadgeConfigاز طریقPropertiesیکChoiceانجام میشود.درایو رنگ گزینه انتخاب شده برای هر فایل را نمایش میدهد تا کاربران به وضوح وضعیت، طبقهبندی و غیره فایل را درک کنند. به عنوان مثال، گزینه "بسیار محرمانه" برای برچسب "حساسیت" ممکن است به رنگ قرمز نمایش داده شود. شما فقط میتوانید یک برچسب نشاندار در یک زمان داشته باشید.
- برچسب استاندارد
برچسبی حاوی صفر یا چند نوع فیلد s. یک برچسب استاندارد ممکن است یک عنوان برچسب مانند "پروژه Moonshot" داشته باشد و تمام فایلهای مربوط به پروژه را نشان دهد. یک برچسب استاندارد همچنین ممکن است چندین فیلد ساختار یافته داشته باشد. برای مثال، برچسبی با عنوان "قرارداد" ممکن است شامل فیلدهای "شرکت"، "تاریخ سررسید"، "وضعیت" و "امضاکنندگان" باشد. هر فیلد از نوع خاصی (متن، تاریخ، انتخاب یا کاربر) است.
 |  |
- میدان
یک جزء قابل تنظیم و تایپ شده از یک برچسب. یک برچسب میتواند صفر یا چند فیلد مرتبط با خود داشته باشد.
- نوع فیلد
- نوع دادهی مقدار مرتبط با فیلد . قابل تنظیم به صورت متن، عدد صحیح، تاریخ، کاربر یا انتخاب. اگر فیلد را با
ListOptionsپیکربندی کنید، میتوانید فیلدهای کاربر و انتخاب را با چندین مقدار تنظیم کنید. نوع انتخاب شده هم بر مقادیر معتبر مربوط به موارد Drive و هم بر گزینههای جستجوی موجود تأثیر میگذارد.
- انتخاب
یکی از چندین گزینهای که کاربر میتواند در فیلد
SelectionOptionsانتخاب کند.- نوع برچسب
همه برچسبها شامل یک
LabelTypeهستند. دو نوع برچسب وجود دارد:- مدیر
برای ایجاد و ویرایش برچسبهای متعلق به مدیر، باید مدیر حساب کاربری با امتیاز مدیریت برچسبها باشید.
مدیران میتوانند برچسبهای مدیریتی را با هر کاربری به اشتراک بگذارند تا به آن کاربر امکان مشاهده و اعمال آنها را در موارد Drive بدهند. تغییر یا خواندن مقادیر برچسب در موارد Drive به مجوزهای زیر نیاز دارد:
اصلاح - برای اینکه یک کاربر بتواند فرادادههای مربوط به یک برچسب مشخص در درایو را تغییر دهد، باید سطوح دسترسی مناسب را داشته باشد:
- مورد درایو:
EDITOR - برچسب:
APPLIER
- مورد درایو:
خواندن - برای اینکه کاربر بتواند فرادادههای مربوط به یک برچسب مشخص در درایو را بخواند یا جستجو کند، باید سطوح دسترسی مناسب را داشته باشد:
- مورد درایو:
READER - برچسب:
READER
- مورد درایو:
کاربران غیر مدیر میتوانند برچسبهای مشترکی ایجاد کنند که دیگران بتوانند آنها را روی موارد Drive اعمال کنند. تیمها میتوانند برچسبهای خود را برای استفاده در داخل تیم بدون نیاز به مدیر ایجاد و سازماندهی کنند.
- طبقهبندی برچسب
فیلدهای برچسب پیکربندیشدهی فعلی که برای اعمال روی فایلهای Drive در اختیار کاربران قرار دارند. همچنین به عنوان طرح برچسب شناخته میشود.
مثالهایی از طبقهبندی برچسبها:
- حساسیت—قرمز، نارنجی، زرد، سبز
- وضعیت - شروع نشده، پیشنویس، در حال بررسی، نهایی
- نوع محتوا—قرارداد، سند طراحی، ماکت
- دپارتمان — بازاریابی، امور مالی، منابع انسانی، فروش
- چرخه حیات برچسب
برچسبها یک چرخه حیات را طی میکنند که در آن ایجاد، منتشر، بهروزرسانی و غیره میشوند. همزمان با عبور یک برچسب از چرخه حیات، ویرایش برچسب آن افزایش مییابد. برای اطلاعات بیشتر، به چرخه حیات برچسب مراجعه کنید.
- بازنگری برچسب
یک نمونه از برچسب. هر زمان که یک برچسب ایجاد، بهروزرسانی، منتشر یا منسوخ شود، ویرایش برچسب افزایش مییابد.
- پیشنویس اصلاحشده
- شمارهی اصلاحیهی نمونهی پیشنویس فعلیِ برچسب. شما میتوانید چندین بهروزرسانی روی یک برچسب انجام دهید که هر کدام شمارهی اصلاحیهی پیشنویس خود را افزایش میدهند، بدون اینکه روی اصلاحیهی منتشر شده تأثیری بگذارد. قابلیت داشتن برچسبهای پیشنویس به شما امکان میدهد بهروزرسانیهای برچسب را قبل از انتشار آزمایش کنید.
- نسخه منتشر شده
- شماره ویرایش نسخه منتشر شده یک برچسب. برچسب منتشر شده نمونهای از برچسب است که در حال حاضر برای کاربران در دسترس است.
مباحث مرتبط
برای کسب اطلاعات بیشتر در مورد توسعه با APIهای Google Workspace، از جمله مدیریت احراز هویت و مجوز، به «شروع به کار به عنوان یک توسعهدهنده Google Workspace» مراجعه کنید.
برای یادگیری نحوه پیکربندی و اجرای یک برنامه ساده Labels API، میتوانید از راهنمای سریع پایتون استفاده کنید.