این صفحه نحوهی برگرداندن برچسبهای خاص از یک منبع فایل گوگل درایو را شرح میدهد.
برای مشخص کردن برچسبهایی که میخواهید بازیابی کنید، از متد files.get یا هر متدی که یک منبع فایل را برمیگرداند، استفاده کنید. بدنه درخواست باید خالی باشد.
در صورت موفقیت، بدنه پاسخ شامل نمونهای از File است.
مثال
نمونه کد زیر نحوه استفاده از fileId به همراه labelId را برای برگرداندن مجموعهای از برچسبهای خاص نشان میدهد. شیء includeLabels لیستی از شناسهها است که با کاما از هم جدا شدهاند. شیء labelInfo در پارامتر fields شامل برچسبهایی است که روی فایل تنظیم شده و در includeLabels درخواست شدهاند.
جاوا
File file = driveService.files().get("FILE_ID").setIncludeLabels("LABEL_ID,LABEL_ID").setFields("labelInfo").execute();
پایتون
file = drive_service.files().get(fileId="FILE_ID", includeLabels="LABEL_ID,LABEL_ID", fields="labelInfo").execute();
نود جی اس
/**
* 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;
}
}
موارد زیر را جایگزین کنید:
- FILE_ID :
fileIdفایل حاوی برچسبها. - LABEL_ID :
labelIdیک برچسب که قرار است برگردانده شود. برای پیدا کردن برچسبها روی یک فایل، از متدfiles.listLabelsاستفاده کنید.
یادداشتها
- هر متدی که یک منبع فایل را برمیگرداند، از فیلد
includeLabelsو پارامتر کوئری پشتیبانی میکند. برای مثال،files.copy،files.listوfiles.update.