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 permet aux développeurs d'appliquer des libellés aux fichiers et aux dossiers, de définir des valeurs de champ de libellé, de lire les libellés et les valeurs de champ des fichiers, et de rechercher des fichiers à l'aide de termes de métadonnées définis par la classification des libellés personnalisés.
Les libellés Drive peuvent faciliter les processus métier en associant des métadonnées aux fichiers et aux dossiers. Voici quelques cas d'utilisation courants des libellés :
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 données de votre organisation. Par exemple, utilisez des libellés pour gérer une règle de protection contre la perte de données (DLP) qui empêche les utilisateurs de télécharger des fichiers dont le libellé "Confidentialité" est défini sur "Top secret".
Organiser et rechercher des fichiers : créez des libellés pour rendre les contenus de votre entreprise plus faciles à trouver. Les membres de votre organisation pourront ainsi rechercher des éléments en fonction de leurs libellés et de leurs champs. Par exemple, appliquez un ensemble de libellés "État de la signature" à "En attente de signature" pour tous les contrats en attente de signature d'ici une date spécifique. La recherche Drive peut ensuite renvoyer ces contrats lorsqu'un utilisateur recherche "en attente de signature".
Vous trouverez ci-dessous une liste des termes courants utilisés par les libellés Drive :
Label
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 du libellé fait partie du nom du libellé. 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.
Champ
Composant typé et définissable d'un libellé. Un libellé peut être associé à zéro ou plusieurs champs. Les champs de sélection et d'utilisateur peuvent être définis avec plusieurs valeurs si le champ est configuré avec ListOptions dans l'API Google Drive Labels.
Field type (Type de champ)
Type de données de la valeur associée au champ. Configurable en tant qu'entier, dateString, texte, utilisateur ou sélection. Le type choisi a un impact à la fois sur les valeurs valides applicables aux éléments Drive et sur les options de requête de recherche disponibles.
Classification des libellés
Champs de libellé configurés et disponibles pour les utilisateurs afin qu'ils puissent les appliquer aux fichiers Drive. Lisibles et modifiables via l'API Drive Labels. Également appelé schéma de libellé.
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é 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/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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)."]]
