Apps Script 網頁應用程式範例

本頁概略說明 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 使用 Google 表單 API,請按照下列步驟設定 OAuth 存取權:

  1. 取得已驗證的 OAuth 存取權杖。

    ScriptApp.getOAuthToken();

  2. 在任何對 API 的 REST 呼叫中提供的 options 引數中加入 OAuth 權杖。

    UrlFetchApp.fetch(Url, options);

如需實際操作範例,請參閱「設定 Apps Script 專案」。設定指南會詳細說明呼叫 API 所需的基本管線,不過,為了讓使用者能直覺地存取 API,您也可以試用及修改我們的範例網頁應用程式。

網頁應用程式使用方式示例

如要瞭解如何直接呼叫所有 Forms API 方法,請前往 GitHub 查看完整範例網頁應用程式。

執行網頁應用程式

設定專案並將其部署為網頁應用程式後,您可以嘗試執行一些基本作業。

  1. 按一下「建立表單」按鈕,即可建立新表單。

    新的表單現在會顯示在「表單 ID:」欄位中,您可以按一下「在 Google 表單中開啟」開啟表單。

  2. 在新視窗中開啟新表單後,請嘗試手動新增幾個問題,然後按一下「Get Form by Id」,即可在右側的 JSON 輸出內容中看到新問題。

您可以隨意探索應用程式中提供的其他方法,並觀察右側的每個作業輸出內容。

使用表單手錶

請注意表單的按鈕。這些程式碼會使用「表單 API 手錶」功能,並執行建立、列出、刪除和更新手錶的基本作業。您必須設定專案,並使用 Cloud Pub/Sub 主題,才能使用這些功能。

如要進一步瞭解 Forms API 監控器和 Cloud Pub/Sub,請參閱「設定及接收推播通知」。

後續步驟

請嘗試自訂範例應用程式,以符合您的需求。範例如下:

  • 在 Google 試算表中建立題庫,然後使用 Apps Script 的 SpreadsheetApp 服務,從試算表擷取題目,填入新表單。
  • 或者,您也可以將題庫放在 SQL 資料庫中,然後使用 Apps Script JDBC 服務,將資料庫中的題目填入表單。
  • 產生測驗,並將分數儲存在 Google 試算表成績單中。
  • 使用 Cloud Pub/Sub 設定專案,並使用「watch」功能產生即時學生排行榜,用來顯示測驗結果。