Method: files.listLabels

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

درخواست HTTP

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

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

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

پارامترها
fileId

string

شناسه فایل

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

پارامترها
maxResults

integer

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

pageToken

string

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

درخواست بدن

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

بدن پاسخگو

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

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

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

object ( Label )

لیست برچسب ها

nextPageToken

string

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

kind

string

این همیشه درایو#labelList است

محدوده مجوز

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

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

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