Method: comments.list

نظرات یک فایل را فهرست می کند.

درخواست HTTP

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

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

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

پارامترها
fileId

string

شناسه فایل

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

پارامترها
includeDeleted

boolean

در صورت تنظیم، همه نظرات و پاسخ ها، از جمله نظرات حذف شده و پاسخ ها (با محتوای حذف شده) برگردانده می شوند.

maxResults

integer

حداکثر تعداد بحث هایی که باید در پاسخ گنجانده شود، که برای صفحه بندی استفاده می شود.

pageToken

string

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

updatedMin

string

فقط بحث هایی که پس از این مهر زمانی به روز شده اند، برگردانده می شوند. قالب بندی شده به عنوان مهر زمانی RFC 3339.

درخواست بدن

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

بدن پاسخگو

فهرستی از نظرات روی یک فایل در Google Drive.

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

نمایندگی JSON 
{
  "kind": string,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (Comment)
    }
  ],
  "nextPageToken": string
}
فیلدها
kind

string

این همیشه drive#commentList است.

items[]

object ( Comment )

لیست نظرات. اگر nextPageToken پر شده باشد، این لیست ممکن است ناقص باشد و یک صفحه اضافی از نتایج باید واکشی شود.

nextPageToken

string

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

محدوده مجوز

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

  • https://www.googleapis.com/auth/docs
  • 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.readonly

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