Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les libellés sont des métadonnées que vous définissez pour aider les utilisateurs à organiser et à trouver les fichiers dans Google Drive, et à leur appliquer des règles. L'API Drive Labels est une API RESTful qui prend en charge les processus métier en associant des métadonnées à vos fichiers Drive. Voici quelques utilisations courantes de cette API :
Classer les contenus selon une stratégie de gouvernance des informations : créez un libellé pour identifier les contenus ou données sensibles nécessitant un traitement particulier.
Par exemple, vous pouvez créer un libellé avec badge (un libellé avec des valeurs d'option codées par couleur) intitulé "Sensibilité" avec les valeurs "Top secret", "Confidentiel" et "Public".
Appliquer des règles aux éléments dans Drive : créez des libellés pour gérer le contenu Drive tout au long de son cycle de vie et vous assurer qu'il respecte les pratiques de conservation des documents de votre organisation. Par exemple, utilisez des libellés pour gérer une règle de protection contre la perte de données (DLP) selon laquelle les fichiers dont le libellé "Sensibilité" est défini sur "Top secret" ne peuvent pas être téléchargés sur un ordinateur.
Organiser et rechercher des fichiers : créez des libellés pour rendre le contenu de votre entreprise plus facile à trouver en permettant aux membres de votre organisation de trouver des éléments en fonction des libellés et de leurs champs. Par exemple, un membre de votre organisation peut utiliser les options de recherche de Drive pour rechercher tous les contrats en attente de signature d'ici une date spécifique.
Vous trouverez ci-dessous une liste des termes courants utilisés dans l'API Drive Labels :
Métadonnées structurées placées sur un fichier Drive.
Les utilisateurs de Drive peuvent attribuer des libellés et définir les valeurs des champs de libellé pour les fichiers. Les libellés sont composés des éléments suivants :
Nom du libellé
Nom de ressource du libellé. L'ID de l'étiquette fait partie du nom de l'étiquette. Selon la requête, le nom se présente sous la forme labels/{id} ou labels/{id}@{revisionId}. Pour en savoir plus, consultez la section Révision des libellés ci-dessous.
ID du libellé
Identifiant unique global du libellé. L'ID fait partie du nom du libellé, mais contrairement au nom, il est cohérent entre les révisions.
Il existe deux styles de libellés :
Libellé avec badge
Libellé avec un type de champ SelectionOptions contenant des choix qui peuvent être associés à un code couleur pour indiquer leur importance. Pour ce faire, définissez badgeConfig via Properties d'un Choice.
Drive affiche la couleur de l'option choisie pour chaque fichier afin que les utilisateurs comprennent clairement l'état, la classification, etc. du fichier.
Par exemple, l'option "Top secret" du libellé avec badge "Confidentialité" peut s'afficher en rouge. Vous ne pouvez avoir qu'un seul libellé avec badge à la fois.
Libellé standard
Libellé contenant zéro ou plusieurs types de champ. Un libellé standard peut avoir un titre, tel que "Projet Moonshot", et indiquer tous les fichiers liés au projet. Un libellé standard peut également comporter plusieurs champs structurés. Par exemple, un libellé intitulé "Contrat" peut contenir les champs "Entreprise", "Date limite", "État" et "Signataires". Chaque champ est d'un type spécifique (texte, date, sélection ou utilisateur).
Composant typé et définissable d'un libellé. Un libellé peut être associé à zéro ou plusieurs champs.
Field type (Type de champ)
Type de données de la valeur associée au champ. Configurable sous forme de texte, d'entier, de date, d'utilisateur ou de sélection. Si vous configurez le champ avec ListOptions, vous pouvez définir les champs "Utilisateur" et "Sélection" avec plusieurs valeurs. Le type choisi a une incidence à la fois sur les valeurs valides applicables aux éléments Drive et sur les options de requête de recherche disponibles.
Tous les libellés incluent un LabelType. Il existe deux types de libellés :
Administrateur
Pour créer et modifier des libellés appartenant à un administrateur, vous devez être administrateur du compte et disposer du droit Gérer les libellés.
Les administrateurs peuvent partager des libellés d'administrateur avec n'importe quel utilisateur pour lui permettre de les afficher et de les appliquer aux éléments Drive. Pour modifier ou lire les valeurs des libellés sur les éléments Drive, vous devez disposer des autorisations suivantes :
Modification : pour qu'un utilisateur puisse modifier les métadonnées d'un élément Drive associées à un libellé donné, il doit disposer des niveaux d'autorisation appropriés :
Élément Drive : EDITOR
Libellé : APPLIER
Lecture : pour qu'un utilisateur puisse lire ou rechercher les métadonnées d'un élément Drive associé à un libellé donné, il doit disposer des niveaux d'autorisation appropriés :
Élément Drive : READER
Libellé : READER
Partagés
Les utilisateurs non administrateurs peuvent créer des libellés partagés que d'autres utilisateurs peuvent appliquer aux éléments Drive. Les équipes peuvent créer et organiser leurs propres libellés à utiliser en leur sein, sans avoir besoin d'un administrateur.
Classification des libellés
Champs de libellé actuellement configurés et disponibles pour les utilisateurs afin qu'ils puissent les appliquer aux fichiers Drive. Également appelé schéma de libellé.
Exemples de classifications de libellés :
Sensibilité : rouge, orange, jaune, vert
État : "Non démarré", "Brouillon", "En cours d'examen" ou "Final"
Type de contenu : contrat, document de conception, maquette
Service : marketing, finances, ressources humaines, ventes
Les libellés suivent un cycle de vie : ils sont créés, publiés, mis à jour, etc. À mesure qu'un libellé progresse dans son cycle de vie, sa révision est incrémentée. Pour en savoir plus, consultez Cycle de vie des libellés.
Révision des libellés
Instance du libellé. Chaque fois qu'un libellé est créé, modifié, publié ou obsolète, la révision du libellé est incrémentée.
Révision brouillon
Numéro de révision de l'instance brouillon actuelle du libellé. Vous pouvez apporter plusieurs modifications à un libellé, chacune incrémentant le numéro de révision du brouillon, sans affecter la révision publiée. La possibilité de créer des libellés brouillons vous permet de tester les modifications apportées aux libellés avant de les publier.
Révision publiée
Numéro de révision de la version publiée d'un libellé. Le libellé "Publié" est l'instance du libellé actuellement disponible pour les utilisateurs.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
