Method: labels.publish

Publiez toutes les modifications apportées au brouillon vers le libellé. Une fois publié, le libellé peut ne 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 du brouillon seront supprimées. Les révisions publiées précédemment 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 susceptible d'invalider ou d'entraîner 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 la publication du libellé: * Le libellé ne peut pas être supprimé directement. Vous devez d'abord la désactiver, puis la supprimer. * Impossible de modifier Field.FieldType. * Les modifications apportées aux options de validation des champs ne peuvent pas rejeter des éléments précédemment acceptés. * 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 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 la valeur sur true pour utiliser les identifiants d'administrateur de l'utilisateur. Le serveur vérifie que l'utilisateur est un administrateur du libellé avant d'autoriser l'accès.
writeControl

object (WriteControl)

Permet de contrôler la manière dont les requêtes d'écriture sont exécutées. La valeur par défaut 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 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 relatif aux autorisations.