Désactiver, activer et supprimer un libellé

Cette page explique comment effectuer les tâches suivantes impliquant des libellés :

  • Désactiver un libellé
  • Activer un libellé
  • Supprimer un libellé

Désactiver un libellé

La désactivation d'un libellé entraîne la création d'une révision publiée désactivée basée sur la révision publiée actuelle. S'il existe une révision brouillon, une nouvelle révision brouillon désactivée est créée à partir de la dernière révision brouillon. Les anciennes révisions brouillon sont supprimées. Pour en savoir plus, consultez la section Cycle de vie des libellés.

Une fois désactivé, les utilisateurs peuvent toujours appliquer ce libellé via l'API. Le libellé apparaît toujours là où il a déjà été appliqué, ainsi que dans les résultats de recherche. Un libellé désactivé peut être supprimé.

Pour désactiver un libellé publié, utilisez la disable méthode sur la labels collection.

Vous devez également spécifier les éléments suivants :

  • Une ressource Label qui représente chaque libellé. Elle contient un Name et un ID de ressource, qui est un identifiant unique global pour le libellé.

  • useAdminAccess est défini sur true pour utiliser les identifiants d'administrateur de l'utilisateur. Le serveur vérifie que l'utilisateur est administrateur du libellé avant d'autoriser l'accès.

Cet exemple utilise l'ID pour désactiver le libellé approprié.

Python

service.labels().disable(
name='labels/ID',
body={
  'use_admin_access': True
}).execute()

Node.js

service.labels.disable({
  'resource': {
    'use_admin_access': true
},
'name': 'labels/ID'
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

Le libellé a le State de DISABLED et l'ID de révision du libellé est incrémenté. Les utilisateurs peuvent appliquer le libellé via l'API. Toutefois, un libellé désactivé n'est pas affiché dans une interface utilisateur, sauf si la showInApply propriété de la disabledPolicy méthode est configurée.

Activer un libellé

L'activation d'un libellé désactivé le restaure à son état publié. Cela entraîne la création d'une révision publiée basée sur la révision publiée désactivée actuelle. S'il existe une révision brouillon désactivée, une nouvelle révision est créée à partir de ce brouillon et est activée. Pour en savoir plus, consultez la section Cycle de vie des libellés.

Pour activer un libellé désactivé, utilisez la enable méthode.

Vous devez également spécifier les éléments suivants :

  • Une ressource Label qui représente chaque libellé. Elle contient un Name et un ID de ressource, qui est un identifiant unique global pour le libellé.

  • useAdminAccess est défini sur true pour utiliser les identifiants d'administrateur de l'utilisateur. Le serveur vérifie que l'utilisateur est administrateur du libellé avant d'autoriser l'accès.

Cet exemple utilise l'ID pour activer le libellé approprié.

Python

service.labels().enable(
name='labels/ID',
body={
  'use_admin_access': True
}).execute()

Node.js

service.labels.enable({
  'resource': {
    'use_admin_access': true
},
'name': 'labels/ID'
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

Le libellé a le State de PUBLISHED et l'ID de révision du libellé est incrémenté. Les utilisateurs peuvent afficher et appliquer le libellé aux fichiers via l'API.

Supprimer un libellé

Seuls les libellés brouillons et désactivés peuvent être supprimés. Lorsqu'un libellé est supprimé, toutes les instances auxquelles il s'appliquait, y compris toutes les valeurs de champ correspondantes saisies par les utilisateurs, sont définitivement supprimées et retirées de ces fichiers Drive.

Pour supprimer un libellé, vous devez d'abord le désactiver, puis utiliser la delete méthode.

Vous devez également spécifier les éléments suivants :

  • Une ressource Label qui représente chaque libellé. Elle contient un Name et un ID de ressource, qui est un identifiant unique global pour le libellé.

  • useAdminAccess est défini sur true pour utiliser les identifiants d'administrateur de l'utilisateur. Le serveur vérifie que l'utilisateur est administrateur du libellé avant d'autoriser l'accès.

Cet exemple utilise l'ID pour supprimer le libellé approprié.

Python

response = service.labels().delete(
  name='labels/ID',
  useAdminAccess=True).execute()

Node.js

service.labels.delete({
  'name': 'labels/ID',
  'use_admin_access': true
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

Le libellé a le State de DELETED et l'ID de révision du libellé est incrémenté. Le libellé ne peut pas être appliqué et les libellés supprimés sont finalement purgés. Pour en savoir plus, consultez la section Cycle de vie des libellés.