Method: forms.watches.create

สร้างนาฬิกาใหม่ หากมีการระบุรหัสนาฬิกา คุณต้องไม่มีการใช้งานรหัสดังกล่าว ขีดจำกัดต่อฟอร์มคือ 1 นาฬิกาต่อ Watch.EventType สำหรับแต่ละโปรเจ็กต์ที่เรียกใช้ นาฬิกาจะหมดอายุหลังจากสร้างนาฬิกาแล้ว 7 วัน (ดู Watch.expire_time)

คำขอ HTTP

POST https://forms.googleapis.com/v1/forms/{formId}/watches

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
formId

string

ต้องระบุ รหัสของแบบฟอร์มที่จะดู

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON
{
  "watch": {
    object (Watch)
  },
  "watchId": string
}
ช่อง
watch

object (Watch)

ต้องระบุ ออบเจ็กต์นาฬิกา ไม่ควรตั้งค่ารหัสในออบเจ็กต์นี้ ใช้ watchId แทน

watchId

string

รหัสที่ใช้สำหรับนาฬิกา หากระบุไว้ จะต้องไม่มีการใช้งานรหัสดังกล่าวอยู่แล้ว หากไม่ได้ระบุไว้ ระบบจะสร้างรหัส ค่านี้ควรมีความยาว 4-63 อักขระ และอักขระที่ถูกต้องคือ /[a-z][0-9]-/

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Watch ที่สร้างขึ้นใหม่

ขอบเขตการให้สิทธิ์

ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • 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

โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์