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

詳しくは、認可ガイドをご覧ください。