یک برچسب را از یک منبع فایل برگردانید

این صفحه نحوه بازگرداندن برچسب های خاص از منبع فایل 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();

پایتون

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 استفاده کنید.

یادداشت