نمای کلی برچسب ها
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
برچسبها ابردادههایی هستند که برای کمک به کاربران در سازماندهی، یافتن و اعمال خطمشی روی فایلها در Google Drive تعریف میکنید. Drive API به توسعه دهندگان این امکان را می دهد که برچسب ها را روی فایل ها و پوشه ها اعمال کنند، مقادیر فیلد برچسب را تنظیم کنند، برچسب ها و مقادیر فیلد را روی فایل ها بخوانند و با استفاده از اصطلاحات فراداده تعریف شده توسط طبقه بندی برچسب سفارشی، فایل ها را جستجو کنند.
برچسبهای Drive میتوانند با پیوست کردن ابرداده به فایلها و پوشهها، از فرآیندهای تجاری پشتیبانی کنند. کاربردهای متداول برچسب ها عبارتند از:
طبقه بندی محتوا برای پیروی از یک استراتژی حاکمیت اطلاعات — یک برچسب برای شناسایی محتوای حساس یا داده هایی که نیاز به رسیدگی ویژه دارند ایجاد کنید. به عنوان مثال، ممکن است یک برچسب با نشان (برچسبی با مقادیر گزینه کدگذاری شده رنگی) با عنوان "حساسیت" با مقادیر "محرمانه"، "محرمانه" و "عمومی" ایجاد کنید.
اعمال خطمشی در مورد موارد در Drive — برای مدیریت محتوای Drive در طول چرخه عمر خود، برچسبهایی ایجاد کنید و اطمینان حاصل کنید که به شیوههای ثبت سوابق سازمان شما پایبند است. به عنوان مثال، از برچسبها برای مدیریت یک خطمشی از دست دادن داده (DLP) استفاده کنید که به موجب آن کاربران نمیتوانند فایلهایی را با برچسب «حساسیت» روی «بسیار محرمانه» دانلود کنند.
فایلها را انتخاب کنید و پیدا کنید — برای افزایش قابلیت جستجو در محتوای شرکت خود، به افراد سازمانتان اجازه دهید موارد را بر اساس برچسبها و فیلدهایشان پیدا کنند، برچسب ایجاد کنید. به عنوان مثال، برچسب "وضعیت امضا" را روی "در انتظار امضا" برای همه قراردادهایی که در یک تاریخ خاص در انتظار امضا هستند اعمال کنید. هنگامی که شخصی «در انتظار امضا» را جستجو میکند، جستجوی Drive میتواند این قراردادها را بازگرداند.
در زیر فهرستی از اصطلاحات رایج مورد استفاده توسط برچسبهای Drive آمده است:
- برچسب بزنید
فراداده ساختاریافته قرار داده شده در فایل Drive. کاربران Drive می توانند برچسب ها را اختصاص دهند و مقادیر فیلد برچسب را برای فایل ها تنظیم کنند. برچسب ها از موارد زیر تشکیل شده اند:
- نام برچسب
- نام منبع برچسب. شناسه برچسب بخشی از نام برچسب است. بسته به درخواست، نام به شکل زیر است:
labels/{id}
یا labels/{id}@{revisionId}
. برای اطلاعات بیشتر، ویرایش برچسب را در زیر ببینید. - شناسه برچسب
- یک شناسه منحصر به فرد جهانی برای برچسب. شناسه بخشی از نام برچسب است، اما برخلاف نام، بین ویرایشها سازگار است.
- میدان
یک جزء تایپ شده و قابل تنظیم از یک برچسب. یک برچسب می تواند صفر یا چند فیلد مرتبط با آن داشته باشد. اگر فیلد با ListOptions
در Google Drive Labels API پیکربندی شده باشد، میتوان فیلدهای انتخاب و کاربر را با چندین مقدار تنظیم کرد.
- نوع میدان
- نوع داده مقدار مربوط به فیلد . قابل تنظیم به عنوان عدد صحیح، dateString، متن، کاربر یا انتخاب. نوع انتخاب شده هم بر مقادیر معتبر قابل اعمال برای موارد Drive و هم بر گزینه های جستجوی موجود تأثیر می گذارد.
- طبقه بندی برچسب
فیلدهای برچسب پیکربندی شده برای استفاده در فایلهای Drive در دسترس کاربران است. قابل خواندن و نوشتن از طریق Drive Labels API. همچنین به عنوان طرح برچسب شناخته می شود.
- بازبینی برچسب
نمونه ای از برچسب. هر زمان که یک برچسب ایجاد، بهروزرسانی، منتشر یا منسوخ شود، بازبینی برچسب افزایش مییابد.
- پیش نویس بازنگری
- شماره بازبینی نمونه پیشنویس فعلی برچسب. میتوانید چندین بهروزرسانی برای یک برچسب انجام دهید، که هر کدام شماره ویرایش پیشنویس خود را افزایش میدهد، بدون اینکه بر ویرایش منتشر شده تأثیری بگذارد. قابلیت داشتن برچسبهای پیشنویس به شما امکان میدهد قبل از انتشار بهروزرسانیهای برچسب را آزمایش کنید.
- ویرایش منتشر شده
- شماره بازبینی نسخه منتشر شده یک برچسب. برچسب منتشر شده نمونه ای از برچسب در دسترس کاربران است.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Labels overview\n\n*Labels* are metadata that you define to help users organize, find, and apply\npolicy to files in Google Drive. The Drive API allows developers to\napply labels to files and folders, set label field values, read labels and field\nvalues on files, and search for files using metadata terms defined by the custom\nlabel taxonomy.\n\nDrive labels can support business processes by attaching metadata\nto files and folders. Common uses for labels 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 users can't download files with a\n \"Sensitivity\" label set to \"Top Secret\".\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, apply a \"Signature Status\" label set\n to \"Awaiting Signature\" to all contracts awaiting signature by a specific\n date. Drive search can then return these contracts when\n someone searches \"awaiting signature\".\n\nBelow is a list of common terms used by Drive labels:\n\n*Label*\n\n: Structured metadata placed on a Drive file.\n Drive users can assign labels and set label field values\n for files. Labels are composed of:\n\n *Label name*\n : The resource name of the label. The *label ID* is 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 is part of the\n label name, but unlike the name, it's consistent between revisions.\n\n*Field*\n\n: An individual typed, settable component of a label. A label can have zero or\n more fields associated with it. Selection and user fields can be set with\n multiple values if the field is configured with\n [`ListOptions`](/workspace/drive/labels/reference/rest/v2/labels#listoptions) in the\n [Google Drive Labels API](/workspace/drive/labels/guides/overview).\n\n *Field type*\n : The data type of the value associated with the *field*. Configurable as\n integer, dateString, text, user, or selection. The type chosen impacts\n both the valid values applicable to Drive items and the\n search query options available.\n\n*Label taxonomy*\n\n: The configured label fields available to users for application to\n Drive files. Readable and writable through the\n Drive Labels API. Also known as the label schema.\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 available to users.\n\nRelated topics\n--------------\n\n- To learn about using labels in Drive, see [Set a label field\n on a file](/workspace/drive/api/guides/set-label).\n- Learn more about the [Drive Labels API](/workspace/drive/labels/guides/overview)."]]