يمكن أن يكون لمؤسستك تصنيفات متعددة، تتضمن التصنيفات أي عدد من الحقول. توضح هذه الصفحة طريقة سرد جميع التصنيفات في ملف واحد على Google Drive.
لإدراج تصنيفات الملفات، استخدِم الطريقة
files.listLabels
. يجب أن يكون نص الطلب فارغًا. تستخدِم الطريقة أيضًا معلَمة طلب البحث الاختيارية
maxResults
لضبط الحدّ الأقصى لعدد التصنيفات التي يتم عرضها لكل صفحة. إذا لم يتم ضبطها،
سيتم عرض 100 نتيجة.
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على قائمة التسميات المطبقة على الملف. وتتوفّر هذه العناصر في العنصر items
من النوع
Label
.
مثال
يوضّح الرمز البرمجي التالي كيفية استخدام fileId
للتصنيف لاسترداد التصنيفات الصحيحة.
Java
List<Label> labelList =
labelsDriveClient.files().listLabels("FILE_ID").execute().getItems();
Python
label_list_response = drive_service.files().listLabels(fileId="FILE_ID").execute();
Node.js
/**
* Lists all the labels on a Drive file
* @return{obj} a list of Labels
**/
async function listLabels() {
// 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 labelListResponse = await service.files.listLabels({
fileId: 'FILE_ID',
});
return labelListResponse;
} catch (err) {
// TODO (developer) - Handle error
throw err;
}
}
استبدل FILE_ID بـ fileId
للملف الذي تريد
قائمة التسميات له.