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 使用 Formss API,請按照下列步驟設定 OAuth 存取權:

  1. 取得限定範圍且經過驗證的 OAuth 存取權杖。

    ScriptApp.getOAuthToken();

  2. 將 OAuth 憑證加入傳送至 API 的任何 REST 呼叫中提供的 options 引數。

    UrlFetchApp.fetch(Url, options);

如需查看相關範例,請參閱「設定 Apps Script 專案」。設定指南會詳細說明呼叫 API 所需的基本水電設備,但如要為使用者提供直覺化的 API 存取權,您也可以試用並修改範例網頁應用程式。

網頁應用程式使用範例

GitHub 提供完整的範例網頁應用程式,可直接呼叫所有 Forms API 方法,以供示範使用。

執行網頁應用程式

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

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

    新表單隨即會顯示在「Form id:」欄位中,只要按一下「Open in Forms」(在表單中開啟) 即可開啟。

  2. 在另一個視窗中開啟新表單後,請嘗試手動新增幾個問題,然後按一下「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 設定專案,並使用手錶功能產生即時學生排行榜,以顯示測驗結果。