Method: forms.responses.list

列出表單的回應。

HTTP 要求

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

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

路徑參數

參數
formId

string

必要欄位。要列出回覆內容的表單 ID。

查詢參數

參數
filter

string

要傳回哪些表單回覆。目前僅支援下列篩選器：

timestamp > N

表示要取得時間戳記 N 之後 (但不包括 N 本身) 提交的所有表單回覆。*。

timestamp >= N

表示要取得在 N 時間戳記當下或之後提交的所有表單回覆。

對於這兩個支援的篩選器，時間戳記必須採用 RFC3339 世界標準時間「Zulu」格式。例如：「2014-10-02T15:01:23Z」和「2014-10-02T15:01:23.045123456Z」。
pageSize

integer

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

string

先前列出回應傳回的頁面符記。如果要填入這個欄位，篩選器的格式和值必須與原始要求相同。

要求主體

要求主體必須為空白。

回應主體

回覆 ListFormResponses 要求。

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

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

詳情請參閱授權指南。