توضّح هذه الصفحة كيفية عرض تصنيفات معيّنة من ملف مرجع Google Drive.
لتحديد التصنيفات التي تريد استرجاعها، استخدِم الإجراء
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
.