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

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