تقدّم هذه الصفحة نظرة عامة على مثال تطبيق الويب في Apps Script لواجهة برمجة التطبيقات Google Forms API.
المتطلبات الأساسية
- فعِّل واجهة برمجة التطبيقات Forms API في مشروعك على Google Cloud.
- إعداد مشروع جديد في Apps Script كما هو موضّح في ملف README على GitHub لنموذج تطبيق الويب
نظرة عامة
تسمح واجهة برمجة التطبيقات Forms API لأي عميل تمّت مصادقته بالوصول إلى واجهة برمجة التطبيقات مباشرةً باستخدام REST.
بما أنّ Apps Script توفّر طريقة سهلة للحصول على كلّ من رمز الوصول OAuth الصالح وإجراء طلبات REST، يسهل دمج Apps Script مباشرةً مع Forms API. توفّر أداة "برمجة التطبيقات" حاليًا خدمة نماذج Google، التي تسمح للنصوص البرمجية بإنشاء "نماذج Google" والوصول إليها وتعديلها. ومع ذلك، إذا كنت تفضّل استخدام واجهة برمجة التطبيقات Forms API مباشرةً من Apps Script، يمكنك إعداد إذن الوصول باستخدام OAuth على النحو التالي:
الحصول على رمز دخول عبر OAuth مصادق عليه ومحدد النطاق
ScriptApp.getOAuthToken();أدرِج رمز OAuth المميّز في وسيطة options المقدَّمة في أي طلبات REST لواجهة برمجة التطبيقات.
UrlFetchApp.fetch(Url, options);
راجِع مقالة إعداد مشروع في Apps Script للحصول على مثال على ذلك. يوضّح دليل الإعداد التفاصيل الأساسية للاتصال بواجهة برمجة التطبيقات، ولكن لتوفير إمكانية وصول سهلة إلى واجهة برمجة التطبيقات للمستخدمين النهائيين، يمكنك أيضًا تجربة نموذج تطبيق الويب وتعديله.
مثال على استخدام تطبيق الويب
يتوفّر على GitHub مثال كامل لتطبيق ويب يستدعي جميع طرق Forms API مباشرةً بغرض التوضيح.
تشغيل تطبيق الويب
بعد إعداد مشروعك ونشره كتطبيق ويب، يمكنك تجربة بعض العمليات الأساسية.
أنشئ نموذجًا جديدًا بالنقر على الزر إنشاء نموذج.
يظهر النموذج الجديد الآن في حقل رقم تعريف النموذج: ويمكنك فتحه من خلال النقر على الفتح في "نماذج Google".
بعد فتح النموذج الجديد في نافذة منفصلة، حاوِل إضافة بعض الأسئلة يدويًا، ثم انقر على الحصول على النموذج حسب رقم التعريف وستظهر لك أسئلتك الجديدة في إخراج JSON على يسار الصفحة.
لا تتردد في استكشاف الطرق الأخرى المتاحة في التطبيق وملاحظة النتيجة على يسار كل عملية.
العمل مع ساعات "نماذج Google"
لاحِظ أيضًا أزرار نماذج الساعات. وتستخدم هذه الطلبات ميزة "عمليات المراقبة" في Forms API وتُجري عمليات أساسية لإنشاء عمليات المراقبة وإدراجها وحذفها وتجديدها. ولاستخدامها، عليك إعداد مشروع يتضمّن مواضيع Cloud Pub/Sub.
لمزيد من المعلومات عن عمليات المراقبة في Forms API وCloud Pub/Sub، اطّلِع على مقالة إعداد الإشعارات الفورية وتلقّيها.
الخطوات التالية
جرِّب تخصيص مثال التطبيق بما يناسب احتياجاتك. وفي ما يلي بعض الأمثلة على ذلك:
- أنشئ بنك أسئلة في جدول بيانات Google، ثم استخدِم خدمة Apps Script SpreadsheetApp لاسترداد الأسئلة من جدول بيانات لملء نماذج جديدة.
- بدلاً من ذلك، يمكن أن يتوفّر بنك الأسئلة في قاعدة بيانات SQL حيث يمكنك استخدام Apps Script خدمة JDBC لتعبئة النماذج بمواد أسئلة من قاعدة البيانات.
- أنشئ اختبارًا واحفظ النتائج في دفتر الدرجات في "جداول بيانات Google".
- يمكنك إعداد مشروعك باستخدام Cloud Pub/Sub واستخدام ميزة ساعات لإنشاء جدول صدارة طلاب في الوقت الفعلي لعرض نتائج الاختبار.