توضح هذه الصفحة طريقة عرض تصنيفات محددة من مورد ملف Google Drive.
لتحديد التصنيفات التي تريد استردادها، استخدِم طريقة files.get
أو أي طريقة تعرض مورد ملف. يجب أن يكون نص الطلب فارغًا.
إذا كانت الإجابة ناجحة، يحتوي نص الاستجابة على مثال
File
.
مثال
يوضّح نموذج الرمز التالي كيفية استخدام fileId
، بالإضافة إلى labelId
، لعرض مجموعة التصنيفات المحدّدة. الكائن includeLabels
هو قائمة من أرقام التعريف مفصولة بفواصل. يحتوي الكائن labelInfo
في المعلَمة fields
على تصنيفات تم ضبطها في الملف وتم طلبها ضمن 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;
}
}
استبدل ما يلي:
- FILE_ID:
fileId
للملف الذي يحتوي على التصنيفات. - LABEL_ID: القيمة
labelId
للتصنيف المطلوب عرضه. لتحديد موقع التصنيفات في ملف، استخدِم طريقةfiles.listLabels
.
Notes
- تتوافق أي طريقة تعرض مورد ملف مع الحقل
includeLabels
ومَعلمة طلب البحث. على سبيل المثال،files.copy
وfiles.list
وfiles.update
.