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éthodefiles.listLabels
.
Remarques
- Toute méthode renvoyant une ressource de fichier accepte le champ et le paramètre de requête
includeLabels
. Par exemple,files.copy
,files.list
etfiles.update
.