Method: forms.watches.create

建立新智慧手錶。如有提供手錶 ID,則不能使用。針對每項叫用專案,在每個表單中,每個 Watch.EventType 只能有一個手錶。智慧手錶建立後會在七天後過期 (請參閱 Watch.expire_time)。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
formId

string

必要欄位。要觀察的表單 ID。

要求主體

要求主體的資料會採用以下結構:

JSON 表示法
{
  "watch": {
    object (Watch)
  },
  "watchId": string
}
欄位
watch

object (Watch)

必要欄位。手錶物件。這個物件不應設定 ID;請改用 watchId

watchId

string

手錶使用的 ID。指定時不得已有使用中的 ID。如未指定,系統會產生 ID。這個值的長度應為 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

詳情請參閱授權指南