Method: comments.list

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
fileId

string

شناسه فایل.

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

پارامترها
includeDeleted

boolean

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

maxResults

integer

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

pageToken

string

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

updatedMin

string

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

درخواست بدنه

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

بدنه پاسخ

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

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

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

object ( Comment )

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

kind

string

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

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

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