مقارنة REST API بخدمة "نماذج Google"

هناك بعض التداخل في الإجراءات التي يمكنك تنفيذها باستخدام Google Forms API وخدمة النماذج في "برمجة تطبيقات Google". يغطّي هذا الدليل أوجه التشابه والاختلاف بينهما لمساعدتك في تحديد الأنسب لمشروعك.

ميزات "نماذج Google" المتاحة

يتوافق كل من REST API و"خدمة النماذج" في "برمجة التطبيقات" مع ميزات "نماذج Google" التي لا يتوافق معها الآخر. تتغيّر القائمة الدقيقة بالميزات المتوافقة بمرور الوقت. يمكنك استعراض بقية المستندات لمعرفة ما إذا كانت ميزة معيّنة متوافقة.

لا تتوافق واجهة REST API مع ما يلي:

  • إرسال الردود على النموذج
  • تضمين بيانات تفصيلية للنموذج أو الردّ في نص إشعارات النشر/الاشتراك

لا تتيح "خدمة النماذج" في "برمجة تطبيقات Google" ما يلي:

  • الاشتراك في أحداث النماذج باستخدام Cloud Pub/Sub
  • ضبط الإجابات الصحيحة لأنواع الأسئلة التي لا تتضمّن خيارات متعدّدة

طلب ميزة جديدة في REST API

تعدّ واجهة REST API أحدث من خدمة "نماذج Google" في Apps Script، وتتم إضافة ميزات جديدة إليها بانتظام. إرسال طلب ميزة إذا كنت تريد أن نعطي الأولوية لميزة معيّنة

السلوك المستند إلى الأحداث

توفّر كل من مشغّلات {apps_script_name_short} والمورد forms.watches في واجهة REST API طريقة لاتّخاذ إجراء عند تغيير نموذج.

يُفضّل استخدام forms.watches في REST API من أجل:

  • الموثوقية القصوى
  • إمكانية التشغيل التفاعلي مع Cloud Pub/Sub
  • الإشعارات عند تعديل النماذج

يُفضّل استخدام مشغّلات "برمجة تطبيقات Google" في الحالات التالية:

  • بيانات النموذج أو الردود المضمَّنة مع كل إشعار
  • المشغّلات المستندة إلى الوقت

الحصص

تختلف حدود الخدمة في Apps Script وForms API.

اللغات والبيئات

إذا كنت تفضّل التطوير باستخدام JavaScript، يمكن أن توفّر لك "برمجة تطبيقات Google" الوقت من خلال أتمتة عملية إعداد مشروع في Google Cloud Console وتدفق الموافقة على OAuth. توفّر "برمجة تطبيقات Google" أيضًا أداة لتعديل الرموز البرمجية مستندة إلى المتصفّح، وتنفّذ الرموز البرمجية على خوادم Google.

من ناحية أخرى، توفّر واجهة REST API مكتبات برامج بلغات عديدة غير JavaScript، ما يتيح لك التطوير باللغة التي تختارها بدون أن تخضع لقيود على وقت التشغيل أو عمليات التنفيذ المتزامنة.

استخدام REST API من "برمجة تطبيقات Google"

إذا كنت تفضّل بيئة تطوير "برمجة تطبيقات Google" ولكنك تريد استخدام ميزات Forms REST API، يمكنك إجراء ذلك باستخدام UrlFetchApp. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد مشروع في "برمجة تطبيقات Google".

لا تتوفّر واجهة Forms REST API بعد كـ خدمة متقدّمة في "برمجة التطبيقات". إرسال طلب ميزة إذا كنت تريد أن تصبح هذه الميزة متاحة

الخطوات التالية