Method: forms.watches.create

Tạo một đồng hồ mới. Nếu bạn cung cấp mã đồng hồ, 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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
formId

string

Bắt buộc. Mã của Biểu mẫu cần theo dõi.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "watch": {
    object (Watch)
  },
  "watchId": string
}
Trường
watch

object (Watch)

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.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/forms.body
  • https://www.googleapis.com/auth/forms.body.readonly
  • https://www.googleapis.com/auth/forms.responses.readonly

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.