網路應用程式

如果您為指令碼建立使用者介面，可以將指令碼發布為網頁應用程式。舉例來說，如果指令碼可讓使用者與支援團隊成員預約，最好將其呈現為網頁應用程式，方便使用者直接透過瀏覽器存取。

只要符合下列規定，獨立指令碼和綁定至 應用程式的指令碼都可以轉換為網頁應用程式。

網頁應用程式相關規定

只要指令碼符合下列規定，即可發布為網頁應用程式：

• 其中包含 doGet(e) 或 doPost(e) 函式。
• 這個函式會傳回 HTML 服務 HtmlOutput 物件或內容服務 TextOutput 物件。

要求參數

當使用者造訪應用程式，或程式向應用程式傳送 HTTP GET 要求時，Apps Script 就會執行 doGet(e) 函式。當程式傳送 HTTP POST 要求給應用程式時，Apps Script 會改為執行 doPost(e)。在兩種情況下，e 引數都代表事件參數，可包含任何要求參數的相關資訊。下表顯示事件物件的結構：

欄位
e.queryString	網址查詢字串部分的值，如果未指定查詢字串，則為 null name=alice&n=1&n=2
e.parameter	與要求參數相對應的鍵/值組合物件。對於有多個值的參數，系統只會傳回第一個值。 {"name": "alice", "n": "1"}
e.parameters	類似 e.parameter 的物件，但每個鍵都有值陣列 {"name": ["alice"], "n": ["1", "2"]}
e.pathInfo	/exec 或 /dev 後面的網址路徑。舉例來說，如果網址路徑結尾為 /exec/hello，路徑資訊就是 hello。
e.contextPath	未使用，一律為空字串。
e.contentLength	POST 要求的長度，或 GET 要求的 -1 332
e.postData.length	與 e.contentLength 相同 332
e.postData.type	POST 主體的 MIME 類型 text/csv
e.postData.contents	POST 主體的內容文字 Alice,21
e.postData.name	一律為「postData」 postData

舉例來說，您可以將 username 和 age 等參數傳遞至網址，如下所示：

https://script.google.com/.../exec?username=jsmith&age=21

接著，您可以顯示參數，如下所示：

function doGet(e) {
  var params = JSON.stringify(e);
  return ContentService.createTextOutput(params).setMimeType(ContentService.MimeType.JSON);
}

在上述範例中，doGet(e) 會傳回以下輸出內容：

{
  "queryString": "username=jsmith&age=21",
  "parameter": {
    "username": "jsmith",
    "age": "21"
  },
  "contextPath": "",
  "parameters": {
    "username": [
      "jsmith"
    ],
    "age": [
      "21"
    ]
  },
  "contentLength": -1
}

警告： 系統保留了下列參數名稱，因此不應在網址參數或 POST 主體中使用：

• c
• sid

使用這些參數可能會導致 HTTP 405 回應，並顯示錯誤訊息「Sorry, the file you have requested does not exist.」如有可能，請更新指令碼，以便使用不同的參數名稱。

將指令碼部署為網頁應用程式

如要將指令碼部署為網路應用程式，請按照下列步驟操作：

1. 在指令碼專案的右上方，依序按一下「部署」 >「新部署」。
2. 按一下「選取類型」旁邊的「啟用部署類型」 >「網頁應用程式」。
3. 在「部署設定」下方的欄位中，輸入有關網頁應用程式的資訊。
4. 按一下「部署」。

您可以將網頁應用程式網址分享給希望使用應用程式的使用者，前提是您已授予對方存取權。

注意： 如果在一個網域中部署的網路應用程式擁有權變更為共用雲端硬碟或其他網域中的帳戶，該應用程式就會停止運作。您可以請新擁有者或協作者在新網域中重新部署網頁應用程式，藉此修正這個問題。或者，如果將網頁應用程式移回原始網域，網頁應用程式就會開始在該網域中運作，而無需重新部署。

測試網頁應用程式部署作業

如要將指令碼當作網頁應用程式進行測試，請按照下列步驟操作：

1. 在指令碼專案的右上方，依序點選「部署」>「測試部署作業」。
2. 按一下「選取類型」旁邊的「啟用部署類型」 >「網頁應用程式」。
3. 按一下網頁應用程式網址下方的「複製」。

4. 在瀏覽器中貼上網址，然後測試網路應用程式。

   這個網址結尾為 /dev，只有具備指令碼編輯權限的使用者才能存取。這個應用程式執行個體一律會執行最近儲存的程式碼，且僅供開發期間測試使用。

警告： 在部署以開發人員身分執行的網路應用程式時，請務必謹慎處理透過 ScriptApp.getOAuthToken() 取得的 OAuth 權杖。這些權杖可授予其他應用程式存取資料的權限，因此請勿將權杖傳送至用戶端。

權限

網頁應用程式的權限會因您選擇執行應用程式的方式而有所不同：

• 以我身分執行應用程式：在這種情況下，無論誰存取網路應用程式，指令碼一律會以您 (指令碼擁有者) 的身分執行。
• 以存取網路應用程式的使用者身分執行應用程式：在這種情況下，指令碼會以使用網路應用程式的有效使用者身分執行。當使用者授權存取權時，網路應用程式會透過這個權限方法顯示指令碼擁有者的電子郵件地址。

警告： 為避免濫用，Apps Script 會限制新使用者授權以使用者身分執行網路應用程式的頻率。這些限制取決於發布帳戶是否屬於 網域，以及其他因素。

注意： 您可以使用共用雲端硬碟在網路應用程式上進行協作。部署共用雲端硬碟中的網路應用程式時，如果選擇「以您自己的身分執行」，網路應用程式就會以部署該應用程式的使用者權限執行 (因為沒有指令碼擁有者)。

在 Google 協作平台中嵌入網頁應用程式

警告： 為了防止惡意使用，嵌入式網頁應用程式仍須遵守存取權限。如果嵌入式網頁應用程式似乎無法運作，請檢查網頁應用程式擁有者和網域管理員設定的權限是否允許使用該應用程式。

如要在 Google 協作平台中嵌入網頁應用程式，必須先部署該應用程式。您也需要 Deploy 對話方塊中的「Deployed URL」。

如要將網頁應用程式嵌入 Sites 頁面，請按照下列步驟操作：

1. 開啟要新增網頁應用程式的「網站」頁面。
2. 依序選取「插入」>「嵌入網址」。
3. 貼上網頁應用程式網址，然後按一下「新增」。

網頁預覽畫面中的框架會顯示網頁應用程式。發布網頁時，網站觀眾可能需要先授權網頁應用程式，才能正常執行。未經授權的網頁應用程式會向使用者顯示授權提示。

網頁應用程式和瀏覽器記錄

建議您讓 Apps Script 網頁應用程式模擬多頁應用程式，或透過網址參數控制動態 UI 的應用程式。為了妥善執行這項操作，您可以定義狀態物件來代表應用程式的 UI 或網頁，並在使用者瀏覽應用程式時，將狀態推送至瀏覽器記錄。您也可以監聽記錄事件，以便在使用者透過瀏覽器按鈕來回瀏覽時，讓網路應用程式顯示正確的 UI。您可以在載入時查詢網址參數，讓應用程式根據這些參數動態建構 UI，讓使用者以特定狀態啟動應用程式。

Apps Script 提供兩個非同步用戶端 JavaScript API，協助您建立與瀏覽器記錄連結的網頁應用程式：

• google.script.history 提供方法，可讓瀏覽器歷史記錄變更時動態回應。這包括將狀態 (您可定義的簡單物件) 推送至瀏覽器記錄、取代記錄堆疊中的頂層狀態，以及設定事件監聽器回呼函式，以便回應記錄變更。

• google.script.url 提供方法，可擷取目前網頁的網址參數和網址片段 (如有)。

這些歷史記錄 API 僅適用於網頁應用程式。不支援側欄、對話方塊或外掛程式。也不建議在嵌入 Google 協作平台的網頁應用程式中使用這項功能。