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

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

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

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

مثال

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

Java

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.

ملاحظات