Method: forms.watches.create

أنشئ ساعة جديدة. في حال تقديم معرّف ساعة، يجب أن يكون غير مستخدَم. لكل مشروع مُشغِّل، يكون الحدّ الأقصى لكلّ نموذج هو مشاهدة واحدة لكل Watch.EventType. تنتهي صلاحية المراقبة بعد سبعة أيام من إنشائها (راجِع Watch.expire_time).

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
formId

string

مطلوب. رقم تعريف النموذج المطلوب مراقبته

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "watch": {
    object (Watch)
  },
  "watchId": string
}
الحقول
watch

object (Watch)

مطلوب. عنصر الساعة يجب عدم ضبط أيّ معرّف لهذا العنصر، ويمكنك استخدام watchId بدلاً منه.
watchId

string

رقم التعريف المراد استخدامه للساعة. يجب ألا يكون المعرّف قيد الاستخدام في حال تحديده. في حال عدم تحديد معرّف، يتم إنشاء معرّف. يجب أن تتألّف هذه القيمة من 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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.