השוואה בין API ל-REST עם שירות טפסים

יש חפיפה מסוימת בין הפעולות שאפשר לבצע באמצעות Google Forms API לבין הפעולות שאפשר לבצע באמצעות Forms Service ב-Apps Script. במדריך הזה מוסבר על הדמיון וההבדלים בין שתי האפשרויות, כדי לעזור לכם להחליט איזו מהן הכי מתאימה לפרויקט שלכם.

תכונות נתמכות ב-Forms

גם REST API וגם Forms Service ב-Apps Script תומכים בתכונות של טפסים שהשני לא תומך בהן. הרשימה המדויקת של התכונות הנתמכות משתנה עם הזמן. אפשר לעיין בשאר מסמכי התיעוד כדי לגלות אם תכונה מסוימת נתמכת.

ה-API ל-REST לא תומך בפעולות הבאות:

  • שליחת תשובות לטופס
  • הוספת נתונים מפורטים מהטופס או מהתשובות לגוף ההתראות של pub/sub

שירות Forms ב-Apps Script לא תומך בפעולות הבאות:

  • הרשמה לקבלת עדכונים על אירועים בטופס באמצעות Cloud Pub/Sub
  • הגדרת תשובות נכונות לסוגי שאלות שהן לא שאלות אמריקאיות

בקשה לתכונה חדשה ב-REST API

ממשק ה-REST API חדש יותר משירות Forms ב-Apps Script, ואנחנו מוסיפים לו תכונות חדשות באופן קבוע. אם אתם רוצים לתת עדיפות לתכונה מסוימת, אתם יכולים לשלוח בקשה להוספת תכונה.

התנהגות מבוססת-אירועים

גם טריגרים של {apps_script_name_short} וגם משאב forms.watches ב-REST API מאפשרים לבצע פעולה כשמתבצע שינוי בטופס.

מומלץ להשתמש ב-API ל-REST forms.watches במקרים הבאים:

  • אמינות מקסימלית
  • יכולת פעולה הדדית עם Cloud Pub/Sub
  • התראות על עריכה של טפסים

מומלץ להשתמש בטריגרים של Apps Script במקרים הבאים:

  • נתוני טופס או תשובות שנכללים בכל התראה
  • טריגרים מבוססי-זמן

מכסות

ל-Apps Script ול-Forms API יש מגבלות שירות שונות.

שפות וסביבות

אם אתם מעדיפים לפתח ב-JavaScript, תוכלו לחסוך זמן באמצעות Apps Script, שמאפשר להפוך לאוטומטיות את ההגדרה של פרויקט במסוף Google Cloud ואת תהליך קבלת ההסכמה של OAuth. ב-Apps Script יש גם עורך קוד מבוסס-דפדפן, והקוד שלכם מורץ בשרתי Google.

מצד שני, ה-API ל-REST מספק ספריות לקוח בשפות רבות מלבד JavaScript, כך שאתם יכולים לפתח בשפה שתבחרו ולא להיות כפופים למגבלות על זמן ריצה או על ביצועים בו-זמניים.

שימוש ב-API ל-REST מ-Apps Script

אם אתם מעדיפים את סביבת הפיתוח של Apps Script אבל רוצים להשתמש בתכונות של Forms REST API, אתם יכולים לעשות זאת באמצעות UrlFetchApp. מידע נוסף זמין במאמר בנושא הגדרת פרויקט Apps Script.

‫Forms REST API עדיין לא זמין כשירות מתקדם של Apps Script. אם רוצים שהתכונה הזו תיתמך, אפשר לשלוח בקשה להוספת תכונה.

השלבים הבאים