Method: comments.list

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

الزامی: پارامتر fields باید تنظیم شود. برای برگرداندن فیلدهای دقیق مورد نیاز، به بازگشت فیلدهای خاص مراجعه کنید.

درخواست HTTP

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

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

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

پارامترها
fileId

string

شناسه فایل

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

پارامترها
includeDeleted

boolean

آیا شامل نظرات حذف شده باشد. نظرات حذف شده شامل محتوای اصلی آنها نخواهد بود.

pageSize

integer

حداکثر تعداد نظرات برای بازگشت در هر صفحه.

pageToken

string

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

startModifiedTime

string

حداقل مقدار 'modifiedTime' برای نظرات نتیجه (RFC 3339 date-time).

درخواست بدن

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

بدن پاسخگو

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

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

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

string

مشخص می کند که این چه نوع منبعی است. مقدار: رشته ثابت "drive#commentList" .

comments[]

object ( Comment )

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

nextPageToken

string

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

محدوده مجوز

به یکی از حوزه های 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.readonly

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