Method: labels.get

Obtenez une étiquette par son nom de ressource. Le nom de la ressource peut être l'un des éléments 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 version 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/v2beta/{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 ê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 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 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.