בדף הזה מופיעה סקירה כללית על דוגמת אפליקציית האינטרנט של 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, שמאפשר לסקריפטים ליצור טפסים של Google Forms, לגשת אליהם ולשנות אותם. עם זאת, אם אתם מעדיפים להשתמש ב-Forms API ישירות מ-Apps Script, צריך להגדיר את הגישה ל-OAuth באופן הבא:
קבלת אסימון גישה מאומת ומוגבל היקף מסוג OAuth.
ScriptApp.getOAuthToken();צריך לכלול את אסימון ה-OAuth בארגומנט options שמסופק בכל קריאה ל-API באמצעות REST.
UrlFetchApp.fetch(Url, options);
דוגמה לכך מופיעה במאמר הגדרת פרויקט Apps Script. במדריך ההגדרה מוסבר בפירוט על הרכיבים הבסיסיים שנדרשים כדי לקרוא ל-API. עם זאת, כדי לספק למשתמשים קצה גישה אינטואיטיבית ל-API, אפשר גם לנסות ולשנות את אפליקציית האינטרנט לדוגמה שלנו.
דוגמה לשימוש באפליקציית אינטרנט
אפליקציית אינטרנט לדוגמה עם קריאה ישירה לכל השיטות של Forms API זמינה ב-GitHub למטרות הדגמה.
הפעלת אפליקציית האינטרנט
אחרי שמגדירים את הפרויקט ופורסים אותו כאפליקציית אינטרנט, אפשר לנסות כמה פעולות בסיסיות.
לוחצים על הלחצן Create Form (יצירת טופס) כדי ליצור טופס חדש.
הטופס החדש יופיע עכשיו בשדה מזהה טופס: תוכלו לפתוח אותו בלחיצה על פתיחה ב-Forms.
אחרי שפותחים את הטופס החדש בחלון נפרד, מנסים להוסיף כמה שאלות באופן ידני, לוחצים על Get Form by Id (קבלת טופס לפי מזהה) והשאלות החדשות יופיעו בפלט ה-JSON בצד שמאל.
אתם יכולים לנסות את השיטות האחרות שזמינות באפליקציה ולראות את הפלט בצד שמאל לכל פעולה.
עבודה עם 'מעקב אחר טפסים'
שימו לב גם ללחצנים של שעוני הטפסים. הם משתמשים בתכונה 'מעקבים' של Forms API ומבצעים פעולות בסיסיות ליצירה, לרישום, למחיקה ולחידוש של מעקבים. כדי להשתמש בהם, צריך להגדיר פרויקט עם נושאים של Cloud Pub/Sub.
מידע נוסף על מעקב אחר Forms API ו-Cloud Pub/Sub זמין במאמר הגדרה וקבלה של התראות דחיפה.
השלבים הבאים
נסו להתאים אישית את אפליקציית הדוגמה לפי הצרכים שלכם. הנה כמה דוגמאות:
- יוצרים מאגר שאלות בגיליון אלקטרוני ב-Google Sheets, ואז משתמשים בשירות SpreadsheetApp של Apps Script כדי לאחזר שאלות מהגיליון וליישב טופס חדשים.
- לחלופין, אפשר לאחסן את מאגר השאלות במסד נתונים של SQL, שבו תוכלו להשתמש ב-JDBC Service של Apps Script כדי לאכלס טפסים בשאלות מהמסד.
- ליצור בוחן ולשמור את הציונים ביומן הציונים ב-Google Sheets.
- מגדירים את הפרויקט באמצעות Cloud Pub/Sub ומשתמשים בתכונה watches כדי ליצור לידרבורד של תלמידים בזמן אמת להצגת תוצאות הבחינות.