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

توضّح هذه الصفحة كيفية عرض تصنيفات معيّنة من مصدر ملف Google Drive.

لتحديد التصنيفات التي تريد استردادها، استخدِم الطريقة files.get أو أي طريقة أخرى تعرض مورد ملف. يجب أن يكون نص الطلب فارغًا.

في حال نجاح الطلب، سيحتوي نص الاستجابة على مثال File.

مثال

توضح عينة التعليمات البرمجية التالية كيفية استخدام fileId بالإضافة إلى labelId لعرض مجموعة التصنيفات المحدّدة. العنصر includeLabels هو قائمة قيم مفصولة بفاصلة لأرقام التعريف. يحتوي الكائن labelInfo في المَعلمة fields على التصنيفات التي تم ضبطها في الملف وتم طلبها ضمن includeLabels.

جافا

File file = driveService.files().get("FILE_ID").setIncludeLabels("LABEL_ID,LABEL_ID").setFields("labelInfo").execute();

Python

file = drive_service.files().get(fileId="FILE_ID", includeLabels="LABEL_ID,LABEL_ID", fields="labelInfo").execute();

Node.js

/**
* Get a Drive file with specific labels
* @return{obj} file with labelInfo
**/
async function getFileWithSpecificLabels() {
  // 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 file = await service.files.get({
      fileId: 'FILE_ID',
      includeLabels: 'LABEL_ID,LABEL_ID',
      fields:'labelInfo',
    });
    return file;
  } catch (err) {
    // TODO (developer) - Handle error
    throw err;
  }
}

غيِّر القيم في السلسلة على الشكل التالي:

  • FILE_ID: fileId الملف الذي يحتوي على التصنيفات
  • LABEL_ID: labelId التصنيف المطلوب إرجاعه للعثور على التصنيفات في ملف، استخدِم الطريقة files.listLabels.

ملاحظات