Les libellés sont des métadonnées que vous définissez pour aider les utilisateurs à organiser, rechercher et appliquer des règles aux fichiers dans Google Drive. L'API Drive Étiquettes est une API RESTful qui prend en charge les processus métier en associant des métadonnées à vos fichiers Drive. Voici quelques cas d'utilisation courants de cette API:
Classer le contenu pour suivre une stratégie de gouvernance des informations : créez un libellé pour identifier le contenu ou les données sensibles nécessitant un traitement spécial. Par exemple, vous pouvez créer un libellé avec badge (avec des valeurs d'options codées par couleur) intitulé "Sensibilité" avec les valeurs "Top secret", "Confidentiel" et "Public".
Appliquer une règle 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 votre organisation concernant la tenue de registres. Par exemple, vous pouvez utiliser des libellés pour gérer une stratégie de protection contre la perte de données selon laquelle les fichiers portant le libellé "Sensibilité" 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 améliorer la visibilité du contenu de votre entreprise en permettant aux membres de votre organisation de trouver des éléments à partir des libellés et de leurs champs. Par exemple, un membre de votre organisation peut utiliser les options de recherche Drive pour trouver tous les contrats en attente de signature avant une date spécifique.
Voici une liste des termes couramment utilisés dans l'API Drive Étiquettes:
- Libellé
Métadonnées structurées placées dans un fichier Drive. Les utilisateurs de Drive peuvent attribuer des libellés et définir des valeurs de champ de libellé pour les fichiers. Les libellés se composent des éléments suivants:
- Nom du libellé
- Nom de ressource du libellé. L'ID du libellé constitue une partie du nom du libellé. Selon la requête, le nom se présente sous la forme suivante :
labels/{id}
oulabels/{id}@{revisionId}
. Pour en savoir plus, consultez la section Révision du libellé ci-dessous. - ID du libellé
- Identifiant global unique du libellé. L'ID constitue une 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 options qui peuvent être codées par couleur pour indiquer l'importance. Pour ce faire, définissezbadgeConfig
via leProperties
d'unChoice
.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 "Sensibilité" peut s'afficher en rouge. Vous ne pouvez avoir qu'un seul libellé avec badge à la fois.
- Libellé standard
Libellé contenant zéro, un ou plusieurs types de champ. Un libellé standard peut porter un titre tel que "Projet Moonshot" et indiquer tous les fichiers liés au projet. Une étiquette standard peut également comporter plusieurs champs structurés. Par exemple, un libellé intitulé "Contrat" peut contenir les champs "Entreprise", "Date d'échéance", "État" et "Signataires". Chaque champ est d'un type spécifique (texte, date, sélection ou utilisateur).
- Champ
Composant typé et définissable d'un libellé. Une étiquette peut être associée à zéro ou plusieurs champs.
- Field type (Type de champ)
- Type de données de la valeur associée au champ. Configurable en tant que texte, entier, date, utilisateur ou sélection. Si vous configurez le champ avec
ListOptions
, vous pouvez définir les champs utilisateur et de sélection sur plusieurs valeurs. Le type choisi affecte à la fois les valeurs valides applicables aux éléments Drive et les options de requête de recherche disponibles.
- Choix
L'une des options parmi lesquelles un utilisateur peut choisir dans un champ
SelectionOptions
.- Type d'étiquette
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'administration avec n'importe quel utilisateur pour lui permettre de les afficher et de les appliquer à des éléments Drive. Pour modifier ou lire les valeurs de libellé des éléments Drive, vous devez disposer des autorisations suivantes:
Modification : pour qu'un utilisateur puisse modifier les métadonnées d'élément Drive associées à un libellé donné, il doit disposer des niveaux d'autorisation appropriés :
- Élément Drive:
EDITOR
- Libellé :
APPLIER
- Élément Drive:
Lecture : pour qu'un utilisateur puisse lire ou rechercher les métadonnées d'élément Drive associées à un libellé donné, il doit disposer des niveaux d'autorisation appropriés :
- Élément Drive:
READER
- Libellé :
READER
- Élément Drive:
Les utilisateurs qui ne sont pas administrateurs peuvent créer des libellés partagés que d'autres peuvent appliquer à des éléments Drive. Les équipes peuvent créer et organiser leurs propres libellés à utiliser au sein de l'équipe sans avoir besoin d'un administrateur.
- Classification des libellés
Champs de libellé actuellement configurés que les utilisateurs peuvent appliquer aux fichiers Drive. Ce schéma est également appelé "schéma d'étiquette".
Exemples de taxonomies de libellés:
- Sensibilité : Rouge, Orange, Jaune, Vert
- État : Non démarré, Brouillon, En cours d'examen, Final
- Type de contenu : contrat, document de conception, maquette
- Service : marketing, finance, ressources humaines, ventes
- Cycle de vie des étiquettes
Les étiquettes passent par un cycle de vie : elles sont créées, publiées, mises à jour, etc. À mesure qu'une étiquette parcourt le cycle de vie, sa révision est incrémentée. Pour en savoir plus, consultez Cycle de vie des étiquettes.
- Révision du libellé
Instance du libellé. Chaque fois qu'un libellé est créé, mis à jour, publié ou obsolète, la révision du libellé est incrémentée.
- Révision du brouillon
- Numéro de révision de l'instance brouillon actuelle du libellé. Vous pouvez apporter plusieurs mises à jour à un libellé, chacune en incrémentant le numéro de révision du brouillon, sans affecter la révision publiée. Les brouillons de libellés vous permettent de tester les mises à jour des étiquettes 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.
Articles associés
Pour en savoir plus sur le développement avec les API Google Workspace, y compris la gestion de l'authentification et des autorisations, consultez Premiers pas en tant que développeur Google Workspace.
Pour apprendre à configurer et à exécuter une application simple utilisant l'API Étiquettes, consultez le guide de démarrage rapide pour Python.