Để giúp người tạo biểu mẫu kiểm soát chặt chẽ hơn những người có thể trả lời, chúng tôi sẽ ra mắt chế độ kiểm soát chi tiết cho người trả lời. Theo mặc định, những biểu mẫu được tạo bằng API sau ngày 31 tháng 3 năm 2026 sẽ ở trạng thái chưa được xuất bản. Để tìm hiểu thêm, hãy xem bài viết Các thay đổi về API đối với Google Biểu mẫu.
Tạo một đồng hồ mới. Nếu bạn cung cấp mã đồng hồ, thì mã đó phải chưa được sử dụng. Đối với mỗi dự án gọi, giới hạn trên mỗi biểu mẫu là một đồng hồ trên mỗi Watch.EventType. Một đồng hồ sẽ hết hạn sau 7 ngày kể từ khi được tạo (xem Watch.expire_time).
Yêu cầu HTTP
POST https://forms.googleapis.com/v1/forms/{formId}/watches
Bắt buộc. Đối tượng đồng hồ. Không nên đặt mã nhận dạng trên đối tượng này; hãy sử dụng watchId.
watchId
string
Mã nhận dạng để sử dụng cho đồng hồ. Nếu được chỉ định, mã nhận dạng không được đang được sử dụng. Nếu không chỉ định, hệ thống sẽ tạo một mã nhận dạng. Giá trị này phải có từ 4 đến 63 ký tự và các ký tự hợp lệ là /[a-z][0-9]-/.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một thực thể Watch mới tạo.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[],["To create a watch, send a POST request to `https://forms.googleapis.com/v1/forms/{formId}/watches`, providing the `formId` in the path. The request body must include a watch object and an optional, unique `watchId` (4-63 characters, lowercase letters, numbers, hyphens). Each project has a limit of one watch per `EventType`, expiring after seven days. Successful requests return the new watch, and a specific authorization scope is required.\n"],null,["# Method: forms.watches.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nCreate a new watch. If a watch ID is provided, it must be unused. For each invoking project, the per form limit is one watch per [Watch.EventType](/workspace/forms/api/reference/rest/v1/forms.watches#EventType). A watch expires seven days after it is created (see [Watch.expire_time](/workspace/forms/api/reference/rest/v1/forms.watches#Watch.FIELDS.expire_time)).\n\n### HTTP request\n\n`POST https://forms.googleapis.com/v1/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 to watch. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------|\n| ``` { \"watch\": { object (/workspace/forms/api/reference/rest/v1/forms.watches#Watch) }, \"watchId\": string } ``` |\n\n| Fields ||\n|-----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `watch` | `object (`[Watch](/workspace/forms/api/reference/rest/v1/forms.watches#Watch)`)` Required. The watch object. No ID should be set on this object; use `watchId` instead. |\n| `watchId` | `string` The ID to use for the watch. If specified, the ID must not already be in use. If not specified, an ID is generated. This value should be 4-63 characters, and valid characters are /\\[a-z\\]\\[0-9\\]-/. |\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Watch](/workspace/forms/api/reference/rest/v1/forms.watches#Watch).\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)."]]
