Method: forms.responses.list

フォームの回答を一覧表示します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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

返すレスポンスの最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合、または 0 の場合、最大 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

詳しくは、認可ガイドをご覧ください。