Method: files.listLabels

Liste les étiquettes d'un fichier.

Requête HTTP

GET https://www.googleapis.com/drive/v2/files/{fileId}/listLabels

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
fileId

string

ID du fichier.

Paramètres de requête

Paramètres
maxResults

integer

Nombre maximal de libellés à renvoyer par page. Si ce champ n'est pas spécifié, la valeur par défaut est 100.

pageToken

string

Jeton permettant de poursuivre une requête de liste précédente sur la page suivante. Il doit être défini sur la valeur de nextPageToken issue de la réponse précédente.

Corps de la requête

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

Corps de la réponse

Liste des libellés appliqués à un fichier.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "items": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
Champs
items[]

object (Label)

Liste des étiquettes.

nextPageToken

string

Jeton de page pour la page de libellés suivante. Ce champ sera absent si la fin de la liste est atteinte. Si le jeton est refusé pour une raison quelconque, il doit être supprimé et la pagination doit être redémarrée à partir de la première page de résultats.

kind

string

Il s'agit toujours de drive#labelList

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

Certains champs d'application sont restreints et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le Guide relatif aux autorisations.