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 ou données sensibles qui nécessitent un traitement particulier. Par exemple, vous pouvez créer un badge (un libellé avec des valeurs d'option codées par couleur) intitulé "Sensibilité" avec les valeurs "Top secret", "Confidentiel" et "Public".

  • Appliquer une règle aux éléments de 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 stratégie 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 les contenus de votre entreprise plus faciles à trouver en permettant aux membres de votre organisation de trouver 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 Libellés Drive:

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 pour les libellés des fichiers. Les libellés se composent des éléments suivants:

Nom de l'étiquette
Nom de la ressource du libellé. L'ID de l'étiquette fait partie du nom de l'étiquette. 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 de l'étiquette
Identifiant unique global de l'étiquette. L'ID fait partie du nom de l'étiquette, 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 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 son état, sa classification, etc. Par exemple, l'option "Top Secret" du badge "Sensibilité" peut s'afficher en rouge. Vous ne pouvez avoir qu'un seul libellé avec badge à la fois.

Étiquette standard

Étiquette contenant zéro ou plusieurs types de champ. Un libellé standard peut avoir un titre, tel que "Projet Moonshot", et indiquer tous les fichiers associé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 de type spécifique (texte, date, sélection ou utilisateur).

Schéma d'un libellé avec badge.
Figure 1. Libellé avec badge
Schéma de libellé standard.
Figure 2 Étiquette standard
Champ

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

Field type (Type de champ)
Type de données de la valeur associée au champ. Peut être configuré 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 sur les valeurs valides applicables aux éléments Drive et sur les options de requête de recherche disponibles.
Choice

L'une des options disponibles pour l'utilisateur 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'administrateur avec n'importe quel utilisateur pour lui permettre de les afficher et de les appliquer aux éléments Drive. Les autorisations suivantes sont requises pour modifier ou lire les valeurs des libellés sur les éléments Drive:

  • Modification : pour qu'un utilisateur puisse modifier les métadonnées de l'élément Drive associé à 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 des é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 qui ne sont pas administrateurs 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 à 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 à appliquer aux fichiers Drive. Également appelé "schéma d'étiquettes".

Exemples de classifications 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, finances, 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. À mesure qu'un libellé passe par le cycle de vie, sa révision de libellé 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, la révision du libellé augmente.

Révision provisoire
Numéro de révision de l'instance provisoire actuelle du libellé. Vous pouvez effectuer plusieurs mises à jour d'un libellé, chacune augmentant son numéro de révision de brouillon, sans affecter la révision publiée. La possibilité de créer des libellés d'ébauche vous permet de tester les mises à jour des 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.