Google Forms API (forms:v1)

2022-03-10

9 new methods | New API

Additions

    Methods
  • forms.forms.get

  • forms.forms.batchUpdate

  • forms.forms.create

      Scopes:

    • https://www.googleapis.com/auth/drive
    • https://www.googleapis.com/auth/drive.file
    • Flat Path: v1/forms

      HTTP Method: POST

      Path: v1/forms

      Description: Create a new form using the title given in the provided form message in the request. *Important:* Only the form.info.title and form.info.document_title fields are copied to the new form. All other fields including the form description, items and settings are disallowed. To create a new form and add items, you must first call forms.create to create an empty form with a title and (optional) document title, and then call forms.update to add the items.

  • forms.forms.responses.get

      Path: v1/forms/{formId}/responses/{responseId}

      Scopes:

    • https://www.googleapis.com/auth/drive
    • https://www.googleapis.com/auth/drive.file
    • Parameters:

        responseId

          Type: string

          Required: Yes

          Location: path

          Description: Required. The response ID within the form.

        formId

          Location: path

          Description: Required. The form ID.

          Type: string

          Required: Yes

      HTTP Method: GET

      Flat Path: v1/forms/{formId}/responses/{responseId}

      Description: Get one response from the form.

      Parameter Order:

    • formId
    • responseId
  • forms.forms.responses.list

      Path: v1/forms/{formId}/responses

      Parameters:

        formId

          Required: Yes

          Type: string

          Description: Required. ID of the Form whose responses to list.

          Location: path

        pageSize

          Type: integer

          Description: The maximum number of responses to return. The service may return fewer than this value. If unspecified or zero, at most 5000 responses are returned.

          Location: query

          Format: int32

        filter

          Description: Which form responses to return. Currently, the only supported filters are: * timestamp > *N* which means to get all form responses submitted after (but not at) timestamp *N*. * timestamp >= *N* which means to get all form responses submitted at and after timestamp *N*. For both supported filters, timestamp must be formatted in RFC3339 UTC "Zulu" format. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

          Type: string

          Location: query

        pageToken

          Type: string

          Description: A page token returned by a previous list response. If this field is set, the form and the values of the filter must be the same as for the original request.

          Location: query

      Scopes:

    • https://www.googleapis.com/auth/drive
    • https://www.googleapis.com/auth/drive.file
    • Flat Path: v1/forms/{formId}/responses

      Description: List a form's responses.

      Parameter Order: formId

      HTTP Method: GET

  • forms.forms.watches.delete

  • forms.forms.watches.renew

      Path: v1/forms/{formId}/watches/{watchId}:renew

      Description: Renew an existing watch for seven days. The state of the watch after renewal is `ACTIVE`, and the `expire_time` is seven days from the renewal. Renewing a watch in an error state (e.g. `SUSPENDED`) succeeds if the error is no longer present, but fail otherwise. After a watch has expired, RenewWatch returns `NOT_FOUND`.

      Parameters:

        watchId

          Type: string

          Description: Required. The ID of the Watch to renew.

          Required: Yes

          Location: path

        formId

          Location: path

          Description: Required. The ID of the Form.

          Required: Yes

          Type: string

      Flat Path: v1/forms/{formId}/watches/{watchId}:renew

      Scopes:

    • https://www.googleapis.com/auth/drive
    • https://www.googleapis.com/auth/drive.file
    • https://www.googleapis.com/auth/drive.readonly
    • HTTP Method: POST

      Parameter Order:

    • formId
    • watchId
  • forms.forms.watches.create

  • forms.forms.watches.list