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

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