Method: forms.watches.renew

تجديد ساعة حالية لمدة سبعة أيام. state للساعة بعد التجديد هو ACTIVE، وexpireTime بعد سبعة أيام من التجديد. سينجح تجديد الساعة التي تحمل حالة خطأ (مثل SUSPENDED) إذا لم يعُد الخطأ متوفّرًا، ولكن سيتعذّر إتمامه بطريقة أخرى. بعد انتهاء صلاحية الساعة، يتم إرجاع Watch.renewal إلى NOT_FOUND.

طلب HTTP

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

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

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

المَعلمات
formId

string

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

string

مطلوبة. رقم تعريف الساعة المطلوب تجديدها.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال 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

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