Method: labels.get

Obtenez un libellé par son nom de ressource. Pour en savoir plus, consultez Rechercher des libellés.

Le nom de la ressource peut être l'un des suivants :

  • labels/{id} – Voir labels/{id}@latest
  • labels/{id}@latest : récupère la dernière révision du libellé.
  • labels/{id}@published : obtient la révision publiée actuelle du libellé.
  • labels/{id}@{revisionId} : obtient le libellé à l'ID de révision spécifié.

Requête HTTP

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

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é.

Peut être l'une des valeurs suivantes :

  • labels/{id} (équivalent à labels/{id}@latest)
  • labels/{id}@latest
  • labels/{id}@published
  • labels/{id}@{revisionId}

Paramètres de requête

Paramètres
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 un administrateur du label avant d'autoriser l'accès.
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 par défaut configurée sont utilisées.
view

enum (LabelView)

Si ce paramètre est spécifié, seuls certains champs appartenant à la vue indiquée sont renvoyés.

Corps de la requête

Le corps de la requête doit être vide.

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.labels.readonly
  • https://www.googleapis.com/auth/drive.admin.labels
  • https://www.googleapis.com/auth/drive.admin.labels.readonly

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