本頁提供 Google Forms API 的 Apps Script 網頁應用程式範例總覽。
必要條件
- 在 Google Cloud 專案中啟用 Forms API。
- 按照範例應用程式的 GitHub README 檔案說明,設定新的 Apps Script 專案。
總覽
表單 API 可讓任何經過驗證的用戶端直接使用 REST 存取 API。
由於 Apps Script 可讓您輕鬆取得有效 OAuth 存取權杖並發出 REST 呼叫,因此您可以直接將 Apps Script 與 Forms API 整合。Apps Script 已提供現有的表單服務,可讓指令碼建立、存取及修改 Google 表單。不過,如果您想直接從 Apps Script 使用 Formss API,請按照下列步驟設定 OAuth 存取權:
取得限定範圍且經過驗證的 OAuth 存取權杖。
ScriptApp.getOAuthToken();
將 OAuth 憑證加入傳送至 API 的任何 REST 呼叫中提供的 options 引數。
UrlFetchApp.fetch(Url, options);
如需查看相關範例,請參閱「設定 Apps Script 專案」。設定指南會詳細說明呼叫 API 所需的基本水電設備,但如要為使用者提供直覺化的 API 存取權,您也可以試用並修改範例網頁應用程式。
網頁應用程式使用範例
GitHub 提供完整的範例網頁應用程式,可直接呼叫所有 Forms API 方法,以供示範使用。
執行網頁應用程式
設定專案並部署為網頁應用程式後,您可以嘗試一些基本作業。
按一下「建立表單」按鈕建立新表單。
新表單隨即會顯示在「Form id:」欄位中,只要按一下「Open in Forms」(在表單中開啟) 即可開啟。
在另一個視窗中開啟新表單後,請嘗試手動新增幾個問題,然後按一下「Get Forms by Id」,這樣新的問題就會出現在右側的 JSON 輸出內容中。
歡迎探索應用程式中的其他可用方法,然後觀察每項作業的右側輸出內容。
使用表單手錶
此外,您也會看到表單手錶的按鈕。這些項目使用表單 API 觀察功能,並執行基本作業以建立、列出、刪除及續訂手錶。您必須建立具有 Cloud Pub/Sub 主題的專案,才能使用這些主題。
如要進一步瞭解 Forms API 觀察與 Cloud Pub/Sub,請參閱「設定及接收推播通知」。
後續步驟
您可以根據自己的需求自訂範例應用程式。例如:
- 在 Google 試算表中建立問卷銀行,然後使用 Apps Script SpreadsheetApp 服務從工作表擷取問題,以填入新表單。
- 或者,問題銀行也可以位於 SQL 資料庫中,您可以使用 Apps Script JDBC 服務將資料庫的問題填入表單。
- 產生測驗,並將分數儲存在 Google 試算表的成績單中。
- 使用 Cloud Pub/Sub 設定專案,並使用手錶功能產生即時學生排行榜,以顯示測驗結果。