أنشِئ ساعة جديدة. في حال تقديم رقم تعريف ساعة، يجب عدم استخدامه. الحدّ الأقصى المسموح به لكل مشروع استدعاء هو مشاهدة واحدة لكل Watch.EventType
، وذلك في كل نموذج. تنتهي صلاحية الساعة بعد سبعة أيام من إنشائها (راجع Watch.expire_time
).
طلب HTTP
POST https://forms.googleapis.com/v1/forms/{formId}/watches
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
formId |
مطلوبة. رقم تعريف النموذج المطلوب مشاهدته. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"watch": {
object ( |
الحقول | |
---|---|
watch |
مطلوبة. كائن الساعة. يجب عدم ضبط معرّف على هذا العنصر. استخدِم السمة |
watchId |
رقم التعريف المطلوب استخدامه للساعة ويجب ألا يكون المعرّف مُستخدَمًا حاليًا، في حال تحديده. إذا لم يتم تحديد ذلك، يتم إنشاء معرّف. يجب أن تتألف هذه القيمة من 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
لمزيد من المعلومات، راجِع دليل التفويض.