إدراج تصنيفات في ملف

يمكن أن يكون لدى مؤسستك تصنيفات متعددة، ويمكن أن يتضمّن كل تصنيف أي عدد من الحقول. توضّح هذه الصفحة كيفية إدراج جميع التصنيفات في ملف واحد على 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 الخاص بالملف الذي تريد الحصول على قائمة التصنيفات الخاصة به.