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

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

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

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

סקירה כללית

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

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

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

    ScriptApp.getOAuthToken();

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

    UrlFetchApp.fetch(Url, options);

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

שימוש לדוגמה באפליקציית אינטרנט

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

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

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

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

    הטופס החדש מופיע עכשיו בשדה Form id: וניתן לפתוח אותו על ידי לחיצה על Open in Forms.

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

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

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

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

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

השלבים הבאים

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

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