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