Les libellés sont des métadonnées que vous définissez pour aider les utilisateurs à organiser, rechercher et appliquer des libellés. pour les fichiers dans Google Drive. L'API Drive Libellés est une API RESTful qui prend en charge les processus métier en joignant des métadonnées à votre Drive . Voici quelques cas d'utilisation courants de cette API:
Classer le contenu afin de suivre une stratégie de gouvernance des informations : créez un pour identifier les données ou contenus sensibles qui nécessitent un traitement particulier. Par exemple, vous pouvez créer un libellé accompagné d'un badge (avec un code couleur les valeurs d'option) intitulée "Sensibilité" avec les valeurs "Top Secret", « Confidentiel », et "Public".
Appliquer la règle aux éléments dans Drive : créez des libellés à gérer Piloter le contenu tout au long de son cycle de vie et s'assurer qu'il respecte aux pratiques de votre organisation en matière de tenue de registres. Par exemple, utilisez des étiquettes pour gérer une règle de perte de données (DLP) en vertu de laquelle les fichiers ayant une "sensibilité" ensemble d'étiquettes par "Top Secret" ne peuvent pas être téléchargées sur un ordinateur.
Organiser et rechercher des fichiers : créez des libellés pour faciliter la recherche dans vos contenu de l'entreprise en permettant aux membres de votre organisation de trouver des éléments étiquettes et leurs champs. Par exemple, un membre de votre organisation peut utiliser Options de recherche Drive pour trouver tous les contrats en attente de signature à une date précise.
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 libellés se composent des éléments suivants:
- Nom du libellé
- Nom de ressource du libellé. L'ID de l'étiquette fait partie de l'
Nom du libellé. En fonction de la demande, le nom se présente sous la forme suivante:
labels/{id}
oulabels/{id}@{revisionId}
. Pour en savoir plus, consultez Révision des étiquettes ci-dessous. - ID du libellé
- Identifiant unique global du libellé. L'identifiant fait partie du nom de l'étiquette, mais contrairement au nom, il reste cohérent entre les révisions.
Il existe deux styles de libellés:
- Libellé avec badge
Une étiquette avec
SelectionOptions
type de champ contenant des choix pouvant être associées à un code couleur pour indiquer l'importance. Pour ce faire, définissezbadgeConfig
via leProperties
surChoice
Drive affiche la couleur de l'option choisie pour chaque fichier afin que les utilisateurs comprendre clairement l'état, la classification, etc., du fichier. Par exemple, la colonne "Top Secret" pour le paramètre "Sensibilité" libellé accompagné d'un badge 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é, comme « Projet Moonshot », et indiquer tous les fichiers liés au projet. Un libellé standard peut aussi être associé des champs structurés. Par exemple, un libellé intitulé "Contrat" pourrait contenant les champs "Entreprise", « Date d’échéance », "État" et "Signataires". Chaque champ est d'un type spécifique (texte, date, sélection ou utilisateur).
<ph type="x-smartling-placeholder"> |
<ph type="x-smartling-placeholder"> |
- Champ
Composant individuel saisi et paramétrable d'un libellé. Une étiquette peut avoir une valeur nulle ou plus de champs qui lui sont associés.
- 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 avec plusieurs valeurs. Le type choisi a une incidence sur les valeurs valides applicables Éléments Drive et options de requête de recherche disponibles.
- Choix
L'une des options proposées par un utilisateur dans un
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 disposer d'un compte administrateur avec Gérer les étiquettes un privilège.
Les administrateurs peuvent partager des libellés d'administrateur avec n'importe quel utilisateur pour lui accorder le de les afficher et de les appliquer aux éléments Drive. Modification ou lecture des valeurs de libellé sur des éléments Drive nécessite les autorisations suivantes:
Modification : permet à un utilisateur de modifier les métadonnées des éléments Drive associées à un libellé donné, l'utilisateur doit disposer des niveaux d'autorisation appropriés:
- Élément Drive:
EDITOR
- Libellé :
APPLIER
- Élément Drive:
Lecture : permet à un utilisateur de lire ou de rechercher les métadonnées des éléments Drive. associé à une étiquette donnée, l'utilisateur doit disposer niveaux d'autorisation:
- É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. aux éléments Drive. Les équipes peuvent créer et organiser leurs propres libellés au sein de l'équipe sans nécessiter l'intervention d'un administrateur.
- Classification des libellés
Champs d'étiquette actuellement configurés auxquels les utilisateurs peuvent 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 ainsi de suite. Lorsqu'une étiquette parcourt le cycle de vie, sa révision d'étiquette est incrémentées. 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 une étiquette, chacune incrémentant sa révision du brouillon sans que la révision publiée ne soit affectée. La possibilité d'avoir Les brouillons de libellés vous permettent 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é. La colonne publiée label 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 sur la gestion d'authentification et d'autorisation, consultez la section Premiers pas Google Workspace développeur.
Pour apprendre à configurer et exécuter une application API Libellés simple, consultez la Guide de démarrage rapide pour Python