Method: files.listLabels

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

درخواست HTTP

GET https://www.googleapis.com/drive/v2/files/{fileId}/listLabels

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
fileId

string

شناسه فایل

پارامترهای پرس و جو

مولفه های
maxResults

integer

حداکثر تعداد برچسب برای بازگشت در هر صفحه. وقتی تنظیم نمی شود، به طور پیش فرض روی 100 تنظیم می شود.

pageToken

string

نشانه برای ادامه درخواست لیست قبلی در صفحه بعد. این باید روی مقدار nextPageToken از پاسخ قبلی تنظیم شود.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

لیستی از برچسب های اعمال شده بر روی یک فایل.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "items": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
زمینه های
items[]

object ( Label )

لیست برچسب ها

nextPageToken

string

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

kind

string

این همیشه drive#labelList است

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

برخی از دامنه ها محدود هستند و برای استفاده از برنامه شما به ارزیابی امنیتی نیاز دارند. برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.