Method: labels.get

Permet d'obtenir une étiquette à partir de son nom de ressource. 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 : récupère la révision actuellement publiée du libellé.
  • labels/{id}@{revisionId} : récupère 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 d'étiquette.

Peut correspondre à l'une des valeurs suivantes:

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

Paramètres de requête

Paramètres
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 bien un administrateur du libellé 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 valeur n'est spécifiée, les valeurs dans la langue configurée par défaut sont utilisées.
view

enum (LabelView)

Si 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 relatif aux autorisations.