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

يمكن أن يكون لدى مؤسستك تصنيفات متعددة، مع تصنيفات تحتوي على أي عدد من الحقول. توضّح هذه الصفحة كيفية إدراج جميع التصنيفات في ملف واحد على Google Drive.

لإدراج تصنيفات الملفات، استخدِم الطريقة files.listLabels. يجب أن يكون نص الطلب فارغًا. تستخدِم الطريقة أيضًا مَعلمة طلب البحث الاختيارية maxResults لضبط الحدّ الأقصى لعدد التصنيفات التي سيتم عرضها في كل صفحة. في حال عدم ضبطها، يتم عرض 100 نتيجة.

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على قائمة التصنيفات المطبَّقة على ملف. وتظهر هذه العناصر ضمن كائن items من النوع Label.

مثال

يوضّح نموذج الرمز البرمجي التالي كيفية استخدام fileId للتصنيف لاسترداد التصنيفات الصحيحة.

JavaPythonNode.js

List<Label> labelList =
labelsDriveClient.files().listLabels("FILE_ID").execute().getItems();

label_list_response = drive_service.files().listLabels(fileId="FILE_ID").execute();

/**
* 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 للملف الذي تريد قائمة التصنيفات له.