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

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

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

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

مثال

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

جاوا

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

پایتون

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

نود جی اس

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