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