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 世界標準時間「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)

傳回的表單回應。注意：清單要求的 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

詳情請參閱授權指南。