Method: forms.watches.create

新しいウォッチを作成する。スマートウォッチ 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)

必須。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

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