Method: forms.responses.list

列出表單的回覆。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
formId

string

必要欄位。要列出其回應的表單 ID。

查詢參數

參數
filter

string

要傳回的表單回應。目前支援的篩選器如下：

timestamp > N

這表示要接收在時間戳記 N 之後 (但不含日期) 提交的所有表單回應。*。

timestamp >= N

也就是接收在時間戳記 N 當天及之後提交的所有表單回應。

兩種支援的篩選器時間戳記都必須採用 RFC3339 UTC「Zulu」格式格式。例如：「2014-10-02T15:01:23Z」以及「2014-10-02T15:01:23.045123456Z」
pageSize

integer

要傳回的回應數量上限。服務傳回的產品數量可能會少於這個值。如果未指定或零，則最多會傳回 5, 000 個回應。
pageToken

string

先前清單回應傳回的網頁權杖。如果設定這個欄位，表單和篩選器的值必須和原始要求的值相同。

要求主體

要求主體必須為空白。

回應主體

回應 ListFormResponsesRequest。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "responses": [
    {
      object (FormResponse)
    }
  ],
  "nextPageToken": string
}
欄位
responses[]

object (FormResponse)

傳回的表單回應。注意：針對清單要求，FormResponse 物件不會傳回 formId 欄位。
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

詳情請參閱授權指南。