許可清單網址

您可以使用允許清單指定預先核准的網址，供指令碼或外掛程式存取。許可清單有助於保護使用者資料。定義許可清單後，指令碼專案就無法存取未加入許可清單的網址。

安裝測試部署時，這個欄位為選填，但建立版本化部署時則為必填。

當指令碼或外掛程式執行下列動作時，您可以使用許可清單：

  • 使用 Apps Script UrlFetch 服務，從外部位置 (例如 HTTPS 端點) 擷取或提取資訊。如要將網址加入擷取許可清單，請在資訊清單檔案中加入 urlFetchWhitelist 欄位。
  • 開啟或顯示網址，以回應使用者動作 (如果 Google Workspace 外掛程式會開啟或顯示 Google 外部的網址，則必須使用此方法)。如要將網址加入允許清單，請在資訊清單檔案中加入 addOns.common.openLinkUrlPrefixes 欄位。

在許可清單中新增前置字串

在資訊清單檔案中指定允許清單時 (加入 addOns.common.openLinkUrlPrefixes 或 urlFetchWhitelist 欄位)，必須加入網址前置字元清單。您在資訊清單中新增的前置字元必須符合下列規定：

  • 每個前置字串都必須是有效的網址。
  • 每個前置字串都必須使用 https://，而非 http://。
  • 每個前置字元都必須有完整網域。
  • 每個前置字串都必須有非空白路徑。舉例來說，https://www.google.com/ 有效，但 https://www.google.com 無效。
  • 您可以使用萬用字元比對網址子網域前置字元。
  • 您可以在 addOns.common.openLinkUrlPrefixes 欄位中使用單一 * 萬用字元來比對所有連結，但我們不建議這麼做，因為這可能會讓使用者資料暴露於風險中，並延長外掛程式審查程序。只有在外掛程式功能需要時，才使用萬用字元。

判斷網址是否與允許清單中的前置字元相符時，適用下列規則：

  • 路徑比對會區分大小寫。
  • 如果前置字元與網址完全相同，即為相符。
  • 如果網址與前置字串相同或為其子項，即為相符。

舉例來說，前置字元 https://example.com/foo 會比對下列網址：

  • https://example.com/foo
  • https://example.com/foo/
  • https://example.com/foo/bar
  • https://example.com/foo?bar
  • https://example.com/foo#bar

使用萬用字元

您可以在 urlFetchWhitelist 和 addOns.common.openLinkUrlPrefixes 欄位中使用單一萬用字元 (*) 比對子網域。您無法使用多個萬用字元比對多個子網域，且萬用字元必須代表網址的前置字元前置字元。

舉例來說，前置字元 https://*.example.com/foo 會比對下列網址：

  • https://subdomain.example.com/foo
  • https://any.number.of.subdomains.example.com/foo

前置字元 https://*.example.com/foo 不符合下列網址：

  • https://subdomain.example.com/bar (後置字串不符)
  • https://example.com/foo (至少須有一個子網域)

嘗試儲存資訊清單時，系統會強制執行部分前置字元規則。舉例來說，如果您嘗試儲存資訊清單，但其中包含下列前置字元，就會發生錯誤：

  • https://*.*.example.com/foo (禁止使用多個萬用字元)
  • https://subdomain.*.example.com/foo (萬用字元必須做為前置字串)