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

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

ملاحظات