Créer et publier un libellé

Cette page explique comment créer et publier un libellé.

Créer un libellé

Pour créer un libellé, utilisez la méthode create sur la collection labels. Les libellés peuvent éventuellement contenir un ou plusieurs Fields.

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

• Un LabelType.

• Un libellé title via la méthode property.

• useAdminAccess est true pour utiliser les identifiants administrateur de l'utilisateur. Le serveur vérifie que l'utilisateur est un administrateur disposant du droit d'accès "Gérer les libellés" avant d'autoriser l'accès.

Cet exemple crée une étiquette d'administrateur standard avec un titre spécifié et un SelectionOptions Field avec deux Choices.

Python

label_body = {
'label_type': 'ADMIN',
'properties': {
    'title': 'TITLE'
},
'fields': [{
    'properties': {
        'display_name': 'DISPLAY_NAME'
    },
    'selection_options': {
        'list_options': {},
        'choices': [{
            'properties': {
                'display_name': 'CHOICE_1'
            }
        }, {
            'properties': {
                'display_name': 'CHOICE_2'
            }
        }]
    }
}]
}
response = service.labels().create(
    body=label_body, useAdminAccess=True).execute()

Node.js

var label = {
'label_type': 'ADMIN',
'properties': {
    'title': 'TITLE'
},
'fields': [{
    'properties': {
    'display_name': 'DISPLAY_NAME'
    },
    'selection_options': {
    'list_options': {},
    'choices': [{
        'properties': {
        'display_name': 'CHOICE_1'
        }
    }, {
        'properties': {
        'display_name': 'CHOICE_2'
        }
    }]
    }
}]
};

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

Le libellé est créé dans UNPUBLISHED_DRAFT State. Il doit être PUBLISHED pour être utilisé sur les fichiers et être visible par les utilisateurs. Pour en savoir plus, consultez Cycle de vie des libellés.

Limites de libellés

Les limites suivantes s'appliquent lorsque vous créez et appliquez des libellés :

• Libellés standards : 150
• Champs par libellé : 10
• Libellés appliqués par l'utilisateur par fichier : 5

Utiliser des champs dans les libellés

Field Type	Actions possibles	Remarques sur le format et limites
SelectionOptions	Sélectionner une ou plusieurs options dans une liste	Nombre maximal d'options acceptées : 200 Nombre maximal de sélections pour un fichier : 10, comme configuré dans ListOptions
IntegerOptions	Saisir une valeur numérique	Seuls les nombres entiers sont acceptés.
DateOptions	Sélectionner une date de calendrier	(Facultatif) Date format peut être défini sur "Long : Mois JJ, AAAA" ou "Court : MM/JJ/AA".
TextOptions	Saisir du texte dans une zone de texte	Le nombre maximal de caractères est de 100.
UserOptions	Sélectionnez un ou plusieurs utilisateurs dans les contacts Google Workspace.	Le nombre maximal d'entrées utilisateur pour un fichier est de 10, comme configuré dans ListOptions.

Publier un libellé

L'API Labels vous permet de publier un libellé brouillon une fois qu'il est terminé.

Pour publier un libellé, utilisez la méthode publish et spécifiez :

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

• useAdminAccess est true pour utiliser les identifiants administrateur de l'utilisateur. Le serveur vérifie que l'utilisateur est un administrateur disposant du droit d'accès "Gérer les libellés" avant d'autoriser l'accès.

Cet exemple utilise ID pour identifier et publier le libellé approprié.

Python

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

Node.js

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

Une fois le libellé publié, il est déplacé vers PUBLISHED State et l'ID de révision du libellé est incrémenté. Le libellé est alors visible par les utilisateurs et peut être appliqué aux fichiers. Pour en savoir plus, consultez Cycle de vie des libellés.

Contraintes lors de la publication de libellés

• Une fois publié, un libellé ne peut plus revenir à son état de brouillon d'origine. Pour en savoir plus, consultez Cycle de vie des libellés.

• La publication d'une étiquette crée une révision nouvellement publiée. Toutes les révisions brouillon précédentes sont supprimées. Les révisions précédemment publiées sont conservées, mais peuvent être supprimées automatiquement si nécessaire.

• Une fois la fiche publiée, certaines modifications ne sont plus autorisées. En règle générale, cela signifie que toute modification qui invalide ou déclenche de nouvelles restrictions sur les métadonnées existantes associées au libellé est refusée. Par exemple, les modifications suivantes apportées à une étiquette ne sont pas autorisées une fois l'étiquette publiée :

  • Le libellé est directement supprimé. (Vous devez d'abord le désactiver, puis le supprimer.)
  • La valeur Field.FieldType a été modifiée.
  • Les options de validation des champs ont été modifiées et rejettent désormais ce qui était auparavant accepté.
  • Une réduction du nombre maximal d'entrées.