Lister les étiquettes d'un fichier

Votre organisation peut avoir plusieurs libellés, chacun pouvant comporter un nombre illimité de champs. Cette page explique comment lister tous les libellés d'un même fichier Google Drive.

Pour lister les libellés de fichier, utilisez la méthode files.listLabels. Le corps de la requête doit être vide. La méthode accepte également le paramètre de requête facultatif maxResults pour définir le nombre maximal de libellés à renvoyer par page. Si cette valeur n'est pas définie, 100 résultats sont renvoyés.

Si la requête aboutit, le corps de la réponse contient la liste des libellés appliqués à un fichier. Elles existent dans un objet items de type Label.

Exemple

L'exemple de code suivant montre comment utiliser fileId du libellé pour récupérer les libellés corrects.

Java

List<Label> labelList =
labelsDriveClient.files().listLabels("FILE_ID").execute().getItems();

Python

label_list_response = drive_service.files().listLabels(fileId="FILE_ID").execute();

Node.js

/**
* Lists all the labels on a Drive file
* @return{obj} a list of Labels
**/
async function listLabels() {
  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app

  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  const auth = new GoogleAuth({scopes: 'https://www.googleapis.com/auth/drive'});
  const service = google.drive({version: 'v3', auth});
  try {
    const labelListResponse = await service.files.listLabels({
      fileId: 'FILE_ID',
    });
    return labelListResponse;
  } catch (err) {
    // TODO (developer) - Handle error
    throw err;
  }
}

Remplacez FILE_ID par le fileId du fichier pour lequel vous souhaitez obtenir la liste des libellés.