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

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