Method: labels.publish

Publiez toutes les modifications apportées au brouillon du libellé. Une fois publié, le libellé ne peut pas revenir à son état de brouillon. Pour en savoir plus, consultez google.apps.drive.labels.v2.Lifecycle.

La publication d'un libellé entraîne la publication d'une nouvelle révision. Toutes les révisions précédentes seront supprimées. Les versions publiées précédentes seront conservées, mais peuvent être supprimées automatiquement si nécessaire.

Une fois publiées, certaines modifications ne sont plus autorisées. En règle générale, toute modification qui invaliderait ou entraînerait de nouvelles restrictions sur les métadonnées existantes associées au libellé sera refusée. Par exemple, les modifications suivantes apportées à un libellé seront refusées après sa publication: * Le libellé ne peut pas être supprimé directement. Vous devez d'abord la désactiver, puis la supprimer. * Field.FieldType ne peut pas être modifié. * Les modifications apportées aux options de validation des champs ne peuvent pas rejeter un élément précédemment accepté. * Réduire le nombre maximal d'entrées.

Requête HTTP

POST https://drivelabels.googleapis.com/v2beta/{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 d'étiquette.

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érifie que l'utilisateur est administrateur de la balise avant d'autoriser l'accès.
writeControl

object (WriteControl)

Permet de contrôler la façon dont les requêtes d'écriture sont exécutées. Par défaut, cette valeur n'est pas définie, 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 valeur n'est spécifiée, les valeurs dans la langue configurée par défaut sont 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.