Lister les étiquettes d'un fichier

Votre organisation peut disposer de plusieurs libellés, qui incluent un nombre illimité de champs. Cette page explique comment répertorier tous les libellés d'un seul fichier Google Drive.

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

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

Exemple

L'exemple de code suivant montre comment utiliser l'fileId du libellé pour récupérer les étiquettes correctes.

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 l'fileId du fichier pour lequel vous souhaitez obtenir la liste des libellés.