Para dar aos criadores de formulários mais controle sobre quem pode responder, estamos lançando controles granulares para os participantes. Os formulários criados com a API após 31 de janeiro de 2026 vão ter um estado não publicado por padrão. Para saber mais, consulte
Mudanças na API do Google Formulários.
Method: forms.watches.list
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 2025-07-25 UTC."],[],["The core content describes listing watches for a specific form. A `GET` request is sent to `https://forms.googleapis.com/v1beta/forms/{formId}/watches`, with `formId` being a required path parameter. The request body must be empty. The successful response, in JSON format, includes an array named \"watches\" which contains watch objects. Authorization requires specific OAuth scopes related to drive or forms, to access this endpoint. A maximum of two watches are allowed.\n"],null,["# Method: forms.watches.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListWatchesResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nReturn a list of the watches owned by the invoking project. The maximum number of watches is two: For each invoker, the limit is one for each event type per form.\n\n### HTTP request\n\n`GET https://forms.googleapis.com/v1beta/forms/{formId}/watches`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------|\n| `formId` | `string` Required. ID of the Form whose watches to list. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nThe response of a ListWatchesRequest.\n\n| JSON representation ||\n|----------------------------------------------------------------------------------------------|---|\n| ``` { \"watches\": [ { object (/forms/api/reference/rest/v1beta/forms.watches#Watch) } ] } ``` |\n\n| Fields ||\n|-------------|--------------------------------------------------------------------------------------------------|\n| `watches[]` | `object (`[Watch](/forms/api/reference/rest/v1beta/forms.watches#Watch)`)` The returned watches. |\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.readonly`\n- `\n https://www.googleapis.com/auth/forms.body`\n- `\n https://www.googleapis.com/auth/forms.body.readonly`\n- `\n https://www.googleapis.com/auth/forms.responses.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
