Renvoyer une étiquette à partir d'une ressource de fichier

Cette page explique comment renvoyer des libellés spécifiques à partir d'une ressource de fichier Google Drive.

Pour spécifier les étiquettes que vous souhaitez récupérer, utilisez la méthode files.get ou toute méthode renvoyant une ressource de fichier. Le corps de la requête doit être vide.

Si la requête aboutit, le corps de la réponse contient une instance de File.

Exemple

L'exemple de code suivant montre comment utiliser fileId et labelId pour renvoyer l'ensemble d'étiquettes spécifiques. L'objet includeLabels est une liste d'ID séparés par une virgule. L'objet labelInfo dans le paramètre fields contient des étiquettes définies sur le fichier et demandées dans includeLabels.

Java

File file = driveService.files().get("FILE_ID").setIncludeLabels("LABEL_ID,LABEL_ID").setFields("labelInfo").execute();

Python

file = drive_service.files().get(fileId="FILE_ID", includeLabels="LABEL_ID,LABEL_ID", fields="labelInfo").execute();

Node.js

/**
* Get a Drive file with specific labels
* @return{obj} file with labelInfo
**/
async function getFileWithSpecificLabels() {
  // 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 file = await service.files.get({
      fileId: 'FILE_ID',
      includeLabels: 'LABEL_ID,LABEL_ID',
      fields:'labelInfo',
    });
    return file;
  } catch (err) {
    // TODO (developer) - Handle error
    throw err;
  }
}

Remplacez les éléments suivants :

  • FILE_ID: fileId du fichier contenant les libellés.
  • LABEL_ID: labelId d'un libellé à renvoyer. Pour localiser les libellés d'un fichier, utilisez la méthode files.listLabels.

Remarques