許可清單網址

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

安裝測試部署作業時，這是選填欄位， 您會建立版本化 Deployment

你可以在指令碼或外掛程式執行期間使用許可清單 以下動作：

  • 從外部位置 (例如 HTTPS) 擷取或擷取資訊 端點) 使用 Apps Script UrlFetch 課程中也會快速介紹 Memorystore 這是 Google Cloud 的全代管 Redis 服務如要將網址加入許可清單，以便進行擷取，請在資訊清單檔案中加入 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 (必須使用萬用字元做為開頭前置字元)