本頁面概要說明 Google Forms API 的 Apps Script 網頁應用程式範例。
必要條件
- 在 Google Cloud 專案中啟用 Forms API。
- 如範例網頁應用程式的 GitHub README 檔案所述,設定新的 Apps Script 專案。
總覽
透過 Forms API,任何經過驗證的用戶端都能使用 REST 直接存取 API。
由於 Apps Script 提供取得有效 OAuth 存取權杖和發出 REST 呼叫的方法,因此可以直接將 Apps Script 與 Forms API 整合。Apps Script 已經提供現有的 Forms 服務,可讓指令碼建立、存取及修改表單。不過,如果您偏好直接從 Apps Script 使用 Forms API,請按照下列步驟設定 OAuth 存取權:
取得已驗證且具範圍的 OAuth 存取權杖。
ScriptApp.getOAuthToken();在對 API 進行任何 REST 呼叫時,請在提供的 options 引數中加入 OAuth 權杖。
UrlFetchApp.fetch(Url, options);
如需實際操作範例,請參閱「設定 Apps Script 專案」。設定指南詳細說明呼叫 API 時所需的基礎架構,但如要為使用者提供直覺式的 API 存取權,您也可以試用及修改我們的範例網頁應用程式。
網頁應用程式範例用法
如要查看直接呼叫所有 Forms API 方法的完整範例網頁應用程式,請前往 apps-script-samples GitHub 存放區。
執行網頁應用程式
設定專案並部署為網頁應用程式後,即可嘗試執行一些作業。
按一下「建立表單」按鈕,建立新表單。
新表單現在會顯示在「表單 ID:」欄位中,你可以按一下「在 Google 表單中開啟」開啟表單。
在新視窗中開啟新表單後,請嘗試手動新增幾個問題,然後按一下「Get Form by Id」,您會在右側的 JSON 輸出內容中看到新問題。
探索應用程式中的其他可用方法,並觀察每項作業右側的輸出內容。
使用 Forms 手錶
請注意,表單也有按鈕,可供觀看。這些項目會使用 Forms API 的監控功能,並執行建立、列出、刪除及續訂監控項目的作業。您必須設定具有 Cloud Pub/Sub 主題的專案,才能使用這些主題。
如要進一步瞭解 Forms API 監控和 Cloud Pub/Sub,請參閱設定及接收推播通知。
後續步驟
您可以嘗試自訂範例應用程式,使其符合您的需求。範例如下:
- 在 Google 試算表中建立題庫,然後使用 Apps Script SpreadsheetApp 服務從試算表擷取問題,填入新表單。
- 或者,您也可以將題庫存放在 SQL 資料庫中,並使用 Apps Script JDBC 服務,從資料庫將問題填入表單。
- 生成測驗,並將分數儲存在 Google 試算表成績單中。
- 使用 Cloud Pub/Sub 設定專案,並使用 watches 功能產生即時學生排行榜,顯示測驗結果。