Method: forms.responses.list

پاسخ های یک فرم را فهرست کنید.

درخواست HTTP

GET https://forms.googleapis.com/v1/forms/{formId}/responses

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

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

مولفه های
formId

string

ضروری. شناسه فرمی که پاسخ‌های آن به فهرست می‌رسد.

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

مولفه های
filter

string

پاسخ های کدام فرم برای بازگشت. در حال حاضر، تنها فیلترهای پشتیبانی شده عبارتند از:

timestamp > N

به این معنی که تمام پاسخ های فرم ارسال شده پس از (اما نه در) زمان N . *

timestamp >= N

به این معنی که تمام پاسخ های فرم ارسال شده در و بعد از مهر زمانی N را دریافت کنید.

برای هر دو فیلتر پشتیبانی شده، مُهر زمانی باید در قالب RFC3339 UTC "Zulu" قالب بندی شود. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z".

pageSize

integer

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

pageToken

string

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

درخواست بدن

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

بدن پاسخگو

پاسخ به یک ListFormResponsesRequest.

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

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

object ( FormResponse )

فرم برگشتی پاسخ می دهد. توجه: فیلد formId در شی FormResponse برای درخواست‌های فهرست برگردانده نمی‌شود.

nextPageToken

string

در صورت تنظیم، پاسخ های بیشتری وجود دارد. برای دریافت صفحه بعدی پاسخ ها، در یک درخواست آینده این را به عنوان pageToken ارائه کنید.

محدوده مجوز

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

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

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