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 libellés que vous souhaitez récupérer, utilisez la méthode files.get ou toute méthode qui renvoie 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, ainsi que labelId, pour renvoyer l'ensemble de libellés spécifiques. L'objet includeLabels est une liste d'ID séparés par une virgule. L'objet labelInfo du paramètre fields contient les libellés définis sur le fichier et demandés 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