Method: labels.publish

Publiez toutes les modifications apportées au brouillon du libellé. Une fois publié, le libellé ne peut plus être remis à l'état de brouillon. Pour en savoir plus, consultez Créer et publier un libellé.

La publication d'un libellé entraîne la publication d'une nouvelle révision. Toutes les révisions brouillon précédentes seront supprimées. Les révisions publiées précédemment seront conservées, mais pourront être supprimées automatiquement si nécessaire. Pour en savoir plus, consultez Cycle de vie des libellés.

Une fois la fiche publiée, certaines modifications ne sont plus autorisées. En règle générale, toute modification qui invaliderait les métadonnées existantes associées au libellé ou qui entraînerait de nouvelles restrictions sera refusée. Par exemple, les modifications suivantes apportées à une étiquette seront refusées après sa publication :

  • Vous ne pouvez pas supprimer directement le libellé. Vous devez d'abord le désactiver, puis le supprimer.
  • "Field.FieldType" ne peut pas être modifié.
  • Les modifications apportées aux options de validation des champs ne peuvent pas refuser un élément qui a été accepté précédemment.
  • Réduire le nombre maximal d'entrées.

Requête HTTP

POST https://drivelabels.googleapis.com/v2/{name=labels/*}:publish

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de la ressource de libellé.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "languageCode": string
}
Champs
useAdminAccess

boolean

Définissez cette valeur sur true pour utiliser les identifiants d'administrateur de l'utilisateur. Le serveur vérifiera que l'utilisateur est un administrateur du label avant d'autoriser l'accès.
writeControl

object (WriteControl)

Permet de contrôler l'exécution des requêtes d'écriture. La valeur par défaut est "non défini", ce qui signifie que la dernière écriture l'emporte.
languageCode

string

Code de langue BCP-47 à utiliser pour évaluer les libellés de champ localisés. Si aucune langue n'est spécifiée, les valeurs de la langue configurée par défaut seront utilisées.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Label.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

Pour en savoir plus, consultez le guide d'autorisation.