Method: forms.watches.create

یک ساعت جدید ایجاد کنید. اگر شناسه ساعت ارائه شده باشد، باید استفاده نشده باشد. برای هر پروژه فراخوانی، محدودیت هر فرم یک ساعت در Watch.EventType است. یک ساعت هفت روز پس از ایجاد منقضی می‌شود (به Watch.expire_time مراجعه کنید).

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
formId

string

ضروری. شناسه فرم برای تماشا.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "watch": {
    object (Watch)
  },
  "watchId": string
}
زمینه های
watch

object ( Watch )

ضروری. شی ساعت. هیچ شناسه ای نباید روی این شی تنظیم شود. به جای آن از watchId استفاده کنید.

watchId

string

شناسه مورد استفاده برای ساعت اگر مشخص شده باشد، شناسه نباید قبلاً در حال استفاده باشد. اگر مشخص نشده باشد، یک شناسه ایجاد می شود. این مقدار باید 4-63 کاراکتر باشد و کاراکترهای معتبر /[az][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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.