Method: forms.watches.create

新しいスマートウォッチを作成します。ウォッチ ID を指定する場合は、未使用のウォッチ ID を使用する必要があります。呼び出し元プロジェクトごとに、フォームごとの上限は Watch.EventType ごとに 1 回です。スマートウォッチは、作成後 7 日間有効です(Watch.expire_time を参照)。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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

詳細については、承認ガイドをご覧ください。