为了让表单创建者能够更好地控制哪些人可以回复,我们将为回复者引入精细的控制功能。2026 年 1 月 31 日之后使用该 API 创建的表单将默认处于未发布状态。如需了解详情,请参阅
Google 表单的 API 变更。
Method: forms.watches.list
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[],["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)."]]