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