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

لمزيد من المعلومات، راجِع دليل التفويض.