Pour permettre aux créateurs de formulaires de contrôler plus précisément qui peut y répondre, nous lançons des contrôles précis pour les personnes interrogées. Les formulaires créés avec l'API après le 31 janvier 2026 seront par défaut publiés. Pour en savoir plus, consultez
Modifications des API dans Google Forms.
Method: forms.watches.list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
