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

返されるレスポンスの最大数。サービスはこの値より少ない値を返すことがあります。指定しないかゼロの場合、最大で 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

詳細については、承認ガイドをご覧ください。