Обзор этикеток
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Метки — это метаданные, которые вы определяете, чтобы помочь пользователям упорядочивать, находить и применять политики к файлам на Google Диске. API Диска позволяет разработчикам добавлять метки к файлам и папкам, задавать значения полей меток, читать метки и значения полей файлов, а также искать файлы, используя метаданные, определяемые пользовательской таксономией меток.
Метки дисков могут поддерживать бизнес-процессы, добавляя метаданные к файлам и папкам. Метки обычно используются:
Классифицируйте контент в соответствии со стратегией управления информацией — создайте метку для обозначения конфиденциального контента или данных, требующих особого обращения. Например, можно создать метку с цветными значениями параметров под названием «Конфиденциальность» с вариантами «Совершенно секретно», «Конфиденциально» и «Публичное».
Применение политики к объектам на Диске — создайте метки для управления содержимым Диска на протяжении всего его жизненного цикла и обеспечьте его соответствие принятым в вашей организации правилам ведения учёта. Например, используйте метки для управления политикой защиты от потери данных (DLP), которая запрещает пользователям загружать файлы с меткой «Конфиденциальность» в значении «Совершенно секретно».
Упорядочивайте и находите файлы — создавайте метки, чтобы упростить поиск контента вашей компании, позволяя сотрудникам находить элементы по меткам и полям. Например, примените метку «Статус подписи» с значением «Ожидает подписания» ко всем договорам, ожидающим подписания к определённой дате. Поиск на Диске может затем возвращать эти договоры при поиске по запросу «ожидает подписания».
Ниже приведен список общих терминов, используемых в метках Диска:
- Этикетка
Структурированные метаданные, размещаемые в файле на Диске. Пользователи Диска могут назначать метки и задавать значения полей меток для файлов. Метки состоят из:
- Название этикетки
- Имя ресурса метки. Идентификатор метки является частью имени метки. В зависимости от запроса имя может иметь вид:
labels/{id}
или labels/{id}@{revisionId}
. Подробнее см. в разделе «Ревизия метки» ниже. - Идентификатор этикетки
- Глобальный уникальный идентификатор метки. Идентификатор является частью имени метки, но, в отличие от имени, он не меняется между версиями.
- Поле
Отдельный типизированный настраиваемый компонент метки. С меткой может быть связано ноль или более полей. Поля выбора и пользовательские поля могут содержать несколько значений, если поле настроено с помощью ListOptions
в API меток Google Диска .
- Тип поля
- Тип данных значения, связанного с полем . Может быть задан как целое число, строка даты, текст, пользователь или выборка. Выбранный тип влияет как на допустимые значения, применимые к элементам Диска, так и на доступные параметры поискового запроса.
- Таксономия этикеток
Настроенные поля меток, доступные пользователям для применения к файлам Диска. Доступны для чтения и записи через API меток Диска. Также известны как схема меток.
- Пересмотр этикетки
Экземпляр метки. Каждый раз, когда метка создается, обновляется, публикуется или становится устаревшей, номер версии метки увеличивается.
- Проект пересмотра
- Номер версии текущего черновика этикетки. Вы можете внести несколько изменений в этикетку, увеличивая каждый раз номер её черновика, не влияя на опубликованную версию. Возможность иметь черновики этикеток позволяет тестировать обновления этикеток перед публикацией.
- Опубликованная редакция
- Номер версии опубликованной версии метки. Опубликованная метка — это экземпляр метки, доступный пользователям.
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-04 UTC.
[null,null,["Последнее обновление: 2025-08-04 UTC."],[],[],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)."]]