דוגמת אפליקציית אינטרנט של Apps Script

בדף הזה מופיעה סקירה כללית על דוגמה לאפליקציית אינטרנט ב-Apps Script עבור Google Forms API.

דרישות מוקדמות

  • מפעילים את Forms API בפרויקט ב-Google Cloud.
  • מגדירים פרויקט חדש של Apps Script כמו שמתואר בקובץ ה-README של GitHub עבור אפליקציית האינטרנט לדוגמה.

סקירה כללית

‫Forms API מאפשר לכל לקוח מאומת לגשת ל-API ישירות באמצעות REST.

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

  1. קבלת אסימון גישה מאומת ל-OAuth עם היקף מוגדר.

    ScriptApp.getOAuthToken();

  2. צריך לכלול את אסימון ה-OAuth בארגומנט options שמועבר בכל קריאה ל-API של REST.

    UrlFetchApp.fetch(Url, options);

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

דוגמה לשימוש באפליקציה למחשב

דוגמה מלאה לאפליקציית אינטרנט שקוראת לכל השיטות של Forms API זמינה במאגר apps-script-samples GitHub.

הפעלת אפליקציית האינטרנט

אחרי שמגדירים את הפרויקט ופורסים אותו כאפליקציית אינטרנט, אפשר לנסות כמה פעולות.

  1. כדי ליצור טופס חדש, לוחצים על הלחצן יצירת טופס.

    הטופס החדש מוצג עכשיו בשדה מזהה הטופס:, ואפשר לפתוח אותו בלחיצה על פתיחה ב-Forms.

  2. אחרי שפותחים את הטופס החדש בחלון נפרד, מנסים להוסיף כמה שאלות באופן ידני, ואז לוחצים על Get Form by Id. השאלות החדשות יופיעו בפלט ה-JSON בצד שמאל.

כדאי לנסות את השיטות האחרות שזמינות באפליקציה ולעקוב אחרי הפלט שמוצג בצד שמאל של כל פעולה.

עבודה עם שעונים ב-Forms

שימו לב גם ללחצנים של טפסים בשעונים. הם משתמשים בתכונת הצפייה ב-Forms API ומבצעים פעולות ליצירה, להצגה, למחיקה ולחידוש של צפיות. כדי להשתמש בנושאים של Cloud Pub/Sub, צריך להגדיר פרויקט.

מידע נוסף על מעקב ב-Forms API ועל Cloud Pub/Sub זמין במאמר בנושא הגדרה וקבלת התראות בדחיפה.

השלבים הבאים

נסו להתאים אישית את האפליקציה לדוגמה לפי הצרכים שלכם. הנה כמה דוגמאות:

  • יוצרים מאגר שאלות בגיליון אלקטרוני ב-Google Sheets, ואז משתמשים בשירות SpreadsheetApp של Apps Script כדי לאחזר שאלות מגיליון ולאכלס טפסים חדשים.
  • לחלופין, אפשר לאחסן את בנק השאלות במסד נתונים של SQL, ואז להשתמש בשירות JDBC של Apps Script כדי לאכלס טפסים בשאלות ממסד הנתונים.
  • ליצור בוחן ולשמור את הציונים בגיליון ציונים ב-Google Sheets.
  • מגדירים את הפרויקט באמצעות Cloud Pub/Sub ומשתמשים בתכונה watches כדי ליצור לידרבורד של תלמידים בזמן אמת ולהציג בו את תוצאות החידון.