Présentation de l'API Drive Labels

Les libellés sont des métadonnées que vous définissez pour aider les utilisateurs à organiser et trouver des fichiers dans Google Drive, et à leur appliquer des règles. L'API Drive Libellés est une API RESTful qui prend en charge les processus métier en joignant 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 qui nécessitent un traitement spécial. Par exemple, vous pouvez créer un libellé avec badge (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 assurez-vous qu'il respecte les pratiques de tenue de registres de votre organisation. Par exemple, vous pouvez utiliser des libellés pour gérer une stratégie de perte de données qui permet de télécharger sur un ordinateur les fichiers dont le libellé "Sensibilité" est défini sur "Top secret".

  • Organiser et rechercher des fichiers : créez des libellés pour faciliter la recherche du contenu de votre entreprise en permettant aux membres de votre organisation de trouver des éléments en fonction de libellés et de leurs champs. Par exemple, un membre de votre organisation peut utiliser les options de recherche de Drive pour trouver tous les contrats en attente de signature à une date spécifique.

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

Libellé

Métadonnées structurées placées dans un fichier Drive. Les utilisateurs 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é fait partie du nom du libellé. Selon la requête, ce nom se présente sous la forme suivante : labels/{id} ou labels/{id}@{revisionId}. Pour en savoir plus, consultez la section Révision des étiquettes 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

Étiquette de type de champ SelectionOptions contenant des choix pouvant être codés 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é accompagné d'un badge "Sensibilité" peut s'afficher en rouge. Vous ne pouvez avoir qu'un seul libellé accompagné d'un badge à la fois.

Libellé standard

Libellé contenant zéro, un ou plusieurs types de champ. Un libellé standard peut avoir un titre de libellé, tel que "Project Moonshot", et indiquer tous les fichiers associé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 des étiquettes avec badge.
Figure 1. Libellé avec badge
Schéma d'étiquette standard.
Figure 2. Libellé standard
Champ

Composant individuel saisi et paramétrable d'un libellé. Une étiquette peut être associée à plusieurs champs ou aucun champ.

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 d'utilisateur et de sélection avec plusieurs valeurs. Le type choisi a une incidence sur les valeurs valides applicables aux éléments Drive et sur les options de requête de recherche disponibles.
Choix

L'une des options qu'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 un administrateur de compte disposant 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 d'éléments Drive, vous devez disposer des autorisations suivantes:

  • Modification : pour qu'un utilisateur puisse modifier les métadonnées des éléments 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éments 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 sans droits d'administrateur 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 pour les utiliser au sein d'une équipe sans avoir besoin d'un administrateur.

Classification des libellés

Champs de libellé actuellement configurés à la disposition des utilisateurs pour les applications sur les fichiers Drive. Également appelé schéma d'étiquette.

Exemples de taxonomies d'étiquettes:

  • Sensibilité : rouge, orange, jaune, vert
  • État : non démarrée, brouillon, en cours d'examen, finale
  • 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 au cours duquel elles sont créées, publiées, mises à jour, etc. Lorsqu'une étiquette franchit le cycle de vie, sa révision d'étiquette est incrémentée. Pour en savoir plus, consultez la section Cycle de vie des étiquettes.

Révision des étiquettes

Instance du libellé. Chaque fois qu'un libellé est créé, mis à jour, publié ou obsolète, la révision du libellé s'incrémente.

Révision du brouillon
Numéro de révision du brouillon actuel du libellé. Vous pouvez effectuer plusieurs mises à jour sur un libellé, chacune incrémentant son numéro de révision de 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.