یک ساعت جدید ایجاد کنید. اگر شناسه ساعت ارائه شده باشد، باید استفاده نشده باشد. برای هر پروژه فراخوانی، محدودیت هر فرم یک ساعت در Watch.EventType
است. یک ساعت هفت روز پس از ایجاد منقضی میشود (به Watch.expire_time
مراجعه کنید).
درخواست HTTP
POST https://forms.googleapis.com/v1/forms/{formId}/watches
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
formId | مورد نیاز. شناسه فرم برای تماشا. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"watch": {
object ( |
فیلدها | |
---|---|
watch | مورد نیاز. شی ساعت. هیچ شناسه ای نباید روی این شی تنظیم شود. به جای آن از |
watchId | شناسه مورد استفاده برای ساعت اگر مشخص شده باشد، شناسه نباید قبلاً در حال استفاده باشد. اگر مشخص نشده باشد، یک شناسه ایجاد می شود. این مقدار باید 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
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.