با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
برچسب‌ها ابرداده‌هایی هستند که برای کمک به کاربران در سازماندهی، یافتن و اعمال خط‌مشی روی فایل‌ها در 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" داشته باشد و همه فایل های مربوط به پروژه را نشان دهد. یک برچسب استاندارد همچنین ممکن است چندین فیلد ساختاریافته داشته باشد. برای مثال، برچسبی با عنوان "قرارداد" ممکن است حاوی فیلدهای "شرکت"، "تاریخ سررسید"، "وضعیت" و "امضاکنندگان" باشد. هر فیلد از نوع خاصی است (متن، تاریخ، انتخاب یا کاربر).
یک جزء تایپ شده و قابل تنظیم از یک برچسب. یک برچسب می تواند صفر یا چند فیلد مرتبط با آن داشته باشد.
نوع میدان
نوع داده مقدار مربوط به فیلد . قابل تنظیم به عنوان متن، عدد صحیح، تاریخ، کاربر یا انتخاب. اگر فیلد را با ListOptions پیکربندی کنید، می توانید فیلدهای کاربر و انتخاب را با چندین مقدار تنظیم کنید. نوع انتخاب شده هم بر مقادیر معتبر قابل اعمال برای موارد Drive و هم بر گزینه های جستجوی موجود تأثیر می گذارد.
همه برچسب ها دارای یک LabelType هستند. 2 نوع برچسب وجود دارد:
مدیر
برای ایجاد و ویرایش برچسب‌های متعلق به سرپرست، باید یک سرپرست حساب با امتیاز مدیریت برچسب‌ها باشید.
سرپرستان می‌توانند برچسب‌های سرپرست را با هر کاربری به اشتراک بگذارند تا به کاربر امکان مشاهده و اعمال آن‌ها در موارد Drive را بدهد. اصلاح یا خواندن مقادیر برچسب در موارد Drive به مجوزهای زیر نیاز دارد:
اصلاح - برای اینکه کاربر بتواند فراداده مورد Drive مربوط به یک برچسب مشخص را تغییر دهد، کاربر باید سطوح مجوز مناسب را داشته باشد:
مورد درایو: EDITOR
برچسب: APPLIER
خواندن — برای اینکه کاربر بتواند فراداده مورد Drive مربوط به یک برچسب مشخص را بخواند یا جستجو کند، کاربر باید سطوح مجوز مناسب را داشته باشد:
مورد درایو: READER
برچسب: READER
به اشتراک گذاشته شده است
کاربران غیر سرپرست می‌توانند برچسب‌های مشترکی ایجاد کنند که دیگران بتوانند روی موارد Drive اعمال کنند. تیم ها می توانند برچسب های خود را برای استفاده در تیم بدون نیاز به سرپرست ایجاد و سازماندهی کنند.
طبقه بندی برچسب
فیلدهای برچسب پیکربندی شده کنونی برای استفاده در فایل‌های Drive در دسترس کاربران است. همچنین به عنوان طرح برچسب شناخته می شود.
برچسب‌ها یک چرخه حیاتی را طی می‌کنند که در آن ایجاد، منتشر، به‌روزرسانی و غیره می‌شوند. همانطور که یک برچسب از طریق چرخه عمر عبور می کند، بازبینی برچسب آن افزایش می یابد. برای اطلاعات بیشتر، چرخه عمر برچسب را ببینید.
بازبینی برچسب
نمونه ای از برچسب. هر زمان که یک برچسب ایجاد، به‌روزرسانی، منتشر یا منسوخ شود، بازبینی برچسب افزایش می‌یابد.
پیش نویس بازنگری
شماره بازبینی نمونه پیش‌نویس فعلی برچسب. می‌توانید چندین به‌روزرسانی برای یک برچسب انجام دهید، که هر کدام شماره ویرایش پیش‌نویس خود را افزایش می‌دهد، بدون اینکه بر ویرایش منتشر شده تأثیری بگذارد. قابلیت داشتن برچسب‌های پیش‌نویس به شما امکان می‌دهد قبل از انتشار به‌روزرسانی‌های برچسب را آزمایش کنید.
ویرایش منتشر شده
شماره بازبینی نسخه منتشر شده یک برچسب. برچسب منتشر شده نمونه ای از برچسب است که در حال حاضر در دسترس کاربران است.
تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Drive Labels API overview\n\n*Labels* are metadata that you define to help users organize, find, and apply\npolicy to files in Google Drive. The Drive Labels API is a RESTful API that\nsupports business processes by attaching metadata to your Drive\nfiles. Common uses for this API are:\n\n- **Classify content to follow an information governance strategy**---Create a\n label to identify sensitive content or data that requires special handling.\n For example, you might create a badged label (a label with color-coded\n option values) titled \"Sensitivity\" with the values of \"Top Secret,\"\n \"Confidential,\" and \"Public.\"\n\n- **Apply policy to items in Drive**---Create labels to manage\n Drive content throughout its lifecycle and ensure it adheres\n to your organization's record keeping practices. For example, use labels to\n manage a data loss policy (DLP) whereby files with a \"Sensitivity\" label set\n to \"Top Secret\" can't be downloaded to a computer.\n\n- **Curate and find files**---Create labels to increase searchability of your\n company's content by letting people in your organization find items based on\n labels and their fields. For example, someone in your organization could use\n Drive search options to find all contracts awaiting signature\n by a specific date.\n\nBelow is a list of common terms used in the Drive Labels API:\n\n[*Label*](/workspace/drive/labels/reference/rest/v2/labels#resource:-label)\n\n: Structured metadata placed on a Drive file.\n Drive users can assign labels and set label field values for\n files. Labels are composed of:\n\n *Label name*\n : The resource name of the label. The *label ID* makes up part of the\n Label name. Depending on the request, the name is in the form of either:\n `labels/{id}` or `labels/{id}@{revisionId}`. For more information, see\n [Label revision](#revision) below.\n\n *Label ID*\n : A globally unique identifier for the label. The ID makes up part of the\n label name, but unlike the name, it's consistent between revisions.\n\n There are 2 styles of labels:\n\n *Badged label*\n\n : A label with a\n [`SelectionOptions`](/workspace/drive/labels/reference/rest/v2/labels#selectionoptions)\n field type containing *choices* that can be color-coded to indicate\n importance. This is done by setting\n [`badgeConfig`](/workspace/drive/labels/reference/rest/v2/labels#BadgeConfig)\n through the\n [`Properties`](/workspace/drive/labels/reference/rest/v2/labels#properties_1) of a\n [`Choice`](/workspace/drive/labels/reference/rest/v2/labels#choice).\n\n Drive displays the color of the chosen option for each file so users\n clearly understand the status, classification, and so on, of the file.\n For example, the \"Top Secret\" option for the \"Sensitivity\" badged label\n might display in red. You can only have one badged label at a time.\n\n *Standard label*\n\n : A label containing zero or more *field type*s. A standard label might\n have a label title, such as \"Project Moonshot,\" and indicate all files\n related to the project. A standard label might also have several\n structured fields. For example, a label with the title \"Contract\" might\n contain the fields for \"Company,\" \"Due Date,\" \"Status,\" and\n \"Signatories.\" Each field is of a specific type (text, date,\n selection, or user).\n\n|----------------------------|------------------------------|\n| **Figure 1.** Badged label | **Figure 2.** Standard label |\n\n[*Field*](/workspace/drive/labels/reference/rest/v2/labels#field)\n\n: An individual typed, settable component of a label. A label can have zero or\n more fields associated with it.\n\n *Field type*\n : The data type of the value associated with the *field* . Configurable as\n text, integer, date, user, or selection. If you configure the field with\n `ListOptions`, you can set the user and selection fields with multiple\n values. The type chosen impacts both the valid values applicable to\n Drive items and the search query options available.\n\n[*Choice*](/workspace/drive/labels/reference/rest/v2/labels#choice)\n\n: One of several options a user can choose from within a `SelectionOptions`\n field.\n\n[*Label type*](/workspace/drive/labels/reference/rest/v2/labels#labeltype)\n\n: All labels include a `LabelType`. There are 2 types of labels:\n\n *Admin*\n\n : To create and edit admin-owned labels, you must be an account\n administrator with the\n [Manage Labels](https://support.google.com/a/answer/1219251#drive_and_docs)\n privilege.\n\n Admins can share admin labels with any user to grant that user the\n ability to view and apply them to Drive items. Modifying or reading\n label values on Drive items requires the following permissions:\n\n - Modifying---For a user to modify the Drive item metadata related to a\n given label, the user must have the appropriate permission levels:\n\n - Drive item: `EDITOR`\n - Label: `APPLIER`\n - Reading---For a user to read or search for the Drive item metadata\n related to a given label, the user must have the appropriate\n permission levels:\n\n - Drive item: `READER`\n - Label: `READER`\n\n *Shared*\n\n : Non-administrator users can create shared labels that others can apply\n to Drive items. Teams can create and organize their own labels for use\n within the team without requiring an administrator.\n\n | **Note:** Shared labels are only available in a closed beta that isn't currently accepting new customers.\n\n*Label taxonomy*\n\n: The currently configured label fields available to users for application to\n Drive files. Also known as the label schema.\n\n Example label taxonomies:\n\n - Sensitivity---Red, Orange, Yellow, Green\n - Status---Not Started, Draft, In Review, Final\n - Content type---Contract, Design Doc, Mockup\n - Department---Marketing, Finance, Human Resources, Sales\n\n[*Label lifecycle*](/workspace/drive/labels/reference/rest/v2/labels#lifecycle)\n\n: Labels go through a lifecycle where they're created, published, updated, and\n so on. As a label makes it through the lifecycle, its *label revision* is\n incremented. For more information, see [Label lifecycle](/workspace/drive/labels/guides/label-lifecycle).\n\n*Label revision*\n\n: An instance of the label. Anytime a label is created, updated, published, or\n deprecated, the label revision increments.\n\n *Draft revision*\n : The revision number of the current draft instance of the label. You can\n make several updates to a label, each incrementing its draft revision\n number, without affecting the published revision. The ability to have\n draft labels lets you test label updates before publishing.\n\n *Published revision*\n : The revision number of the published version of a label. The published\n label is the instance of the label currently available to users.\n\nRelated topics\n--------------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to [Get started as a\n Google Workspace\n developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Labels API app, try the\n [Python quickstart](/workspace/drive/labels/quickstart/python)."]]
