Présentation de l'API Drive Labels

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 Labels est une API RESTful compatible avec 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 sensibles ou les données nécessitant un traitement particulier. Par exemple, vous pouvez créer un libellé avec badge (un libellé dont les valeurs d'option sont 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 en vigueur dans 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 rechercher 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 avant une date spécifique.

Vous trouverez ci-dessous une liste des termes courants utilisés dans l'API Drive Labels :

Libellé

Métadonnées structurées placées sur 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 sont composés des éléments suivants :

Nom du libellé
Nom de la 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 du libellé ci-dessous.
ID du libellé
Identifiant global unique 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 SelectionOptions type de champ contenant choix qui peuvent être codés par couleur pour indiquer leur importance. Pour ce faire, définissez badgeConfig via les 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 "Sensibilité" 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 de libellé, 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).

Diagramme de libellé avec badge.
Figure 1. Libellé avec badge
Schéma des libellés standards.
Figure 2. Libellé standard
Champ

Composant individuel typé et définissable d'un libellé. Un libellé peut être associé à zéro ou plusieurs champs.

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 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.
Choix

L'une des nombreuses options qu'un utilisateur peut choisir dans un champ SelectionOptions.

Type de libellé

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 un compte administrateur avec le Gérer les libellés privilège.

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. La modification ou la lecture des valeurs de libellé sur les éléments Drive nécessitent les 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ées à 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 peuvent appliquer aux é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.

Taxonomie 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 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 libellés

Les libellés suivent un cycle de vie au cours duquel ils sont créés, publiés, mis à jour, etc. Au fur et à mesure qu'un libellé progresse dans son cycle de vie, sa révision est incrémentée. Pour en savoir plus, consultez la section Cycle de vie des libellés.

Révision du libellé

Instance du libellé. Chaque fois qu'un libellé est créé, mis à jour, publié ou obsolète, sa révision 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 son numéro de révision brouillon, sans affecter la révision publiée. La possibilité d'avoir des libellés brouillons vous permet de tester les mises à jour de 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.