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 É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} 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 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éfinissez badgeConfig via le 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, 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).

Schéma d'une étiquette avec badge.
Figure 1 : Libellé avec badge
Schéma des étiquettes standards.
Figure 2 : Libellé standard
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
  • 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
Shared (Partagé)

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.