برچسب‌ها را روی یک فایل فهرست کنید

سازمان شما می‌تواند چندین برچسب داشته باشد، با برچسب‌هایی که هر تعداد فیلد دارند. این صفحه نحوه فهرست کردن همه برچسب‌ها را در یک فایل Google Drive توضیح می‌دهد.

برای فهرست کردن برچسب‌های فایل، از روش files.listLabels استفاده کنید. بدنه درخواست باید خالی باشد. این روش همچنین از پارامتر query اختیاری maxResults استفاده می‌کند تا حداکثر تعداد برچسب‌ها را برای بازگشت در هر صفحه تنظیم کند. اگر تنظیم نشود، 100 نتیجه برگردانده می شود.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی لیستی از برچسب های اعمال شده بر روی یک فایل است. اینها در یک شی items از نوع Label وجود دارند.

مثال

نمونه کد زیر نحوه استفاده از fileId برچسب را برای بازیابی برچسب های صحیح نشان می دهد.

جاوا

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

پایتون

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

Node.js

/**
* 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 فایلی که لیست برچسب‌ها را برای آن می‌خواهید جایگزین کنید.