Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Метки — это метаданные, которые вы определяете, чтобы помочь пользователям упорядочивать, находить и применять политики к файлам на Google Диске. API меток Диска — это RESTful API, который поддерживает бизнес-процессы, добавляя метаданные к файлам на Диске. Этот API обычно используется:
Классифицируйте контент в соответствии со стратегией управления информацией — создайте метку для обозначения конфиденциального контента или данных, требующих особого обращения. Например, можно создать метку с цветными значениями параметров под названием «Конфиденциальность» с вариантами «Совершенно секретно», «Конфиденциально» и «Публичное».
Применение политики к объектам на Диске — создайте метки для управления содержимым Диска на протяжении всего его жизненного цикла и обеспечьте его соответствие принятым в вашей организации правилам ведения учёта. Например, используйте метки для управления политикой защиты от потери данных (DLP), согласно которой файлы с меткой «Конфиденциальность» (Sensitivity) и меткой «Совершенно секретно» не будут загружены на компьютер.
Упорядочивайте и находите файлы — создавайте метки, чтобы повысить удобство поиска по контенту вашей компании, позволяя сотрудникам вашей организации находить элементы по меткам и полям. Например, сотрудник вашей организации может использовать возможности поиска на Диске, чтобы найти все договоры, ожидающие подписания к определенной дате.
Ниже приведен список общих терминов, используемых в API Drive Labels:
Структурированные метаданные, размещаемые в файле на Диске. Пользователи Диска могут назначать метки и задавать значения полей меток для файлов. Метки состоят из:
Название этикетки
Имя ресурса метки. Идентификатор метки является частью имени метки. В зависимости от запроса имя может иметь вид: labels/{id} или labels/{id}@{revisionId} . Подробнее см. в разделе «Ревизия метки» ниже.
Идентификатор этикетки
Глобальный уникальный идентификатор метки. Идентификатор является частью имени метки, но, в отличие от имени, он не меняется от версии к версии.
Существует 2 стиля этикеток:
Этикетка с значком
Метка с полем типа SelectionOptions , содержащим варианты выбора , которые можно кодировать цветом для обозначения важности. Это делается путём настройки badgeConfig в Properties варианта Choice .
Диск отображает цвет выбранного параметра для каждого файла, чтобы пользователи могли чётко понимать статус, классификацию и т. д. файла. Например, параметр «Совершенно секретно» для метки «Конфиденциальность» может отображаться красным цветом. Одновременно можно использовать только одну метку.
Стандартная этикетка
Метка, содержащая ноль или более полей разных типов . Стандартная метка может иметь заголовок, например, «Проект «Лунный выстрел», и указывать все файлы, связанные с проектом. Стандартная метка также может иметь несколько структурированных полей. Например, метка с заголовком «Контракт» может содержать поля «Компания», «Срок выполнения», «Статус» и «Подписанты». Каждое поле имеет определённый тип (текст, дата, выборка или пользователь).
Отдельный типизированный настраиваемый компонент метки. С меткой может быть связано ноль или более полей.
Тип поля
Тип данных значения, связанного с полем . Можно настроить как текст, целое число, дату, пользователя или выборку. При настройке поля с помощью ListOptions можно задать поля пользователя и выбора с несколькими значениями. Выбранный тип влияет как на допустимые значения, применимые к элементам Диска, так и на доступные параметры поискового запроса.
Все метки содержат атрибут LabelType . Существует два типа меток:
Администратор
Для создания и редактирования меток, принадлежащих администратору, вы должны быть администратором учетной записи с привилегией «Управление метками» .
Администраторы могут предоставлять любому пользователю доступ к меткам администратора, чтобы он мог просматривать и применять их к объектам Диска. Для изменения или чтения значений меток объектов Диска требуются следующие разрешения:
Изменение — чтобы пользователь мог изменять метаданные элемента Диска, связанные с заданной меткой, у него должны быть соответствующие уровни разрешений:
Элемент диска: EDITOR
Метка: APPLIER
Чтение — чтобы пользователь мог читать или искать метаданные элемента Диска, связанные с заданной меткой, у него должны быть соответствующие уровни разрешений:
Элемент диска: READER
Метка: READER
Общий
Пользователи без прав администратора могут создавать общие метки, которые другие пользователи могут применять к объектам на Диске. Команды могут создавать и упорядочивать собственные метки для использования внутри команды без участия администратора.
Таксономия этикеток
Текущие настроенные поля меток, доступные пользователям для применения к файлам на Диске. Также известны как схема меток.
Этикетки проходят жизненный цикл, в течение которого они создаются, публикуются, обновляются и т. д. По мере прохождения жизненного цикла метки её номер версии увеличивается. Подробнее см. в разделе Жизненный цикл метки .
Пересмотр этикетки
Экземпляр метки. Каждый раз, когда метка создается, обновляется, публикуется или становится устаревшей, номер версии метки увеличивается.
Проект пересмотра
Номер версии текущего черновика этикетки. Вы можете внести несколько изменений в этикетку, увеличивая каждый раз номер её черновика, не влияя на опубликованную версию. Возможность иметь черновики этикеток позволяет тестировать обновления этикеток перед публикацией.
Опубликованная редакция
Номер версии опубликованной версии метки. Опубликованная метка — это экземпляр метки, доступный пользователям в данный момент.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[],[],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)."]]
