管理已安裝的 Firebase 擴展

若要安裝或管理擴充程序，您必須被指派下列角色之一： Owner 或 Editor或Firebase Admin 。

Firebase 控制台Firebase CLI

查看已安裝擴充實例的詳細資訊和配置

1. 前往 Firebase 控制台中的Firebase Extensions 資訊中心。

2. 在已安裝的擴充實例的卡上，按一下管理。

監控已安裝的擴充實例

在 Firebase 控制台中，您可以監控已安裝擴充功能的活動，包括檢查其運行狀況、使用情況和日誌。

設定預算提醒

一般來說，設定預算警報是一種很好的做法，但當您信任另一方的程式碼在您的專案中運行時，警報可能尤其重要。

確保為您的 Firebase 專案設定預算提醒。

查看擴充功能建立的函數

1. 前往 Firebase 控制台的功能儀表板。

2. 在「儀表板」標籤中，您可以查看 Firebase Extensions 中的函數（以及您為專案部署的任何其他函數）。

   擴充功能建立的函數具有名稱，格式為： ext- extension-instance-id - functionName

   例如： ext-awesome-task-simplifier-onUserCreate

查看擴充功能建立的 Cloud Scheduler 作業

1. 在 Google Cloud Console 中開啟專案的Cloud Scheduler頁面。

2. 在作業清單中，您可以查看 Firebase Extensions 中的 Cloud Scheduler 作業（以及您為專案建立的任何其他作業）。

   由擴充功能建立的作業的名稱格式如下： firebase-ext- extension-instance-id - functionName

   例如： firebase-ext-awesome-task-simplifier-doTask

查看並管理擴展排隊的雲端任務

某些擴充程式使用雲端任務來運行運行時間較長的任務：最常見的是，處理在擴充功能生命週期中的各個點（安裝、重新配置和升級後）運行的任務。

通常，這些任務會自動運行並完成，無需您的介入。但是，如果您需要手動管理擴充功能的排隊任務（例如，暫停佇列或從佇列中刪除尚未開始的任務），請依照下列步驟操作：

1. 在 Firebase 控制台擴充部分中，開啟擴充實例的詳細資訊頁面。

2. 在詳細資訊頁面上，開啟API 和資源部分。如果擴充功能使用雲端任務，則會有一個包含一個或多個條目的雲端任務佇列部分。

3. 按一下要管理的佇列的查看佇列。這將開啟 Google Cloud Console 中的「佇列詳細資料」頁面，您可以在其中查看排隊的任務、暫停佇列、從佇列中刪除任務等。請參閱 Cloud Tasks 文件中的管理佇列和任務。

   注意：您可以暫停佇列，但如果暫停時間太長，恢復佇列時任務可能會失敗並出現驗證錯誤。 （任務驗證在加入隊列一小時後過期。）
   警告：不要刪除佇列；擴充功能需要它才能運作。如果您不小心刪除了佇列，則必須執行以下操作：

   1. 安裝擴充功能的新實例。
   2. 僅在安裝新實例後，卸載舊實例。

查看擴充功能建立的 Cloud Secret Manager 金鑰

1. 在 Google Cloud Console 中開啟專案的Secret Manager頁面。

2. 在 Secrets 清單中，您可以查看為 Firebase Extensions 建立的 Secrets（以及您為專案建立的任何其他 Secrets）。

   擴充所建立的金鑰的名稱格式如下： ext- extension-instance-id - paramnName

   例如： ext-awesome-task-simplifier-API_KEY

   秘密標有關鍵firebase-extensions-managed 。除非您想封鎖 Firebase 管理金鑰，否則請勿刪除此標籤。

檢查已安裝的擴充功能是否正常

您可以在控制台中查看函數（包括 Firebase 擴充功能建立的錯誤）中的所有錯誤。

1. 在函數儀表板的運作狀況標籤中，您可以查看專案中所有函數的錯誤和效能資訊的概述。

2. 若要查看特定擴充功能的信息，請使用頁面頂部的篩選器選擇特定功能。

檢查已安裝擴充的運作頻率

1. 在「函數」儀表板的「儀表板」標籤中，找到要檢查的 Firebase 擴充功能的特定函數。

2. 按一下條目最右側的 （溢出選單），然後選擇詳細使用情況統計資料。

3. 在顯示的 Google Cloud Console 中，您可以深入了解函數的各種調用，甚至檢查其原始程式碼。

查看擴充功能的日誌

如果您嘗試偵錯專案或向 Firebase 提交錯誤報告，那麼查看專案中執行的函數的日誌會很有用。

在函數儀表板的日誌標籤中，使用頁面頂部的篩選器選擇由您的擴充功能建立的函數。

將已安裝的擴充功能實例更新至最新版本

您可以將已安裝的擴充實例更新至最新發佈的版本。您可能想要更新已安裝的實例，因為該實例已在您的測試、專案或應用程式工作流程中主動執行或設定。

當您更新實例時，所有實例的特定於擴充功能的資源和邏輯都會被覆寫，以使用新版本的原始程式碼和檔案。擴充功能的實例 ID 和服務帳戶不會變更。

在更新過程中，您將收到有關新版本的任何變更的通知，並且您將能夠指定任何新參數的值。

1. 前往您的Firebase 擴充儀表板，然後在已安裝的擴充實例的卡片上，點選管理。

2. 在右上角，按一下「更新擴充功能」 。

   如果擴充功能沒有可用的新版本，則詳細資訊頁面將不會有更新按鈕。

3. 查看更新中的新增內容並配置擴充（如果需要）。

4. 點擊更新擴充功能。

重新配置已安裝的擴充實例

您可以變更已安裝的擴充實例的使用者配置參數的值。這些新值將在實例的任何未來觸發器中使用，但擴充功能創建的所有先前工件或結構元素（例如儲存的圖像或現有的儲存桶）將不會更改。

1. 前往您的Firebase 擴充儀表板，然後在已安裝的擴充實例的卡片上，點選管理。

2. 在右上角，點擊重新配置擴充功能。

3. 請依照螢幕上的指示重新配置分機的參數值。

4. 按一下「儲存」 。

注意：儲存對分機的變更可能需要係統 3-5 分鐘的時間。

卸載擴充實例

您可以從 Firebase 專案中卸載擴充功能的實例。此操作將刪除 Firebase 專門為該擴充功能實例建立的服務帳戶和所有資源（例如一組函數）。但以下內容不會被刪除：

• 擴充創建的任何工件（例如儲存的圖像）。

• 專案中的任何其他資源，例如資料庫執行個體或 Cloud Storage 儲存分區。即使擴充功能與這些其他資源進行交互，它們也不是特定於擴充功能的，因此如果卸載擴充功能，它們也不會被刪除。

以下是卸載擴充功能的方法：

1. 前往您的Firebase 擴充儀表板，然後在已安裝的擴充實例的卡片上，點選管理。

2. 在螢幕底部，按一下「卸載擴充功能」 。

3. 查看要刪除的內容，然後按一下「卸載擴充功能」以確認刪除。