安裝 Firebase 擴展

您可以使用 Firebase 控制台或Firebase CLI （命令行界面）安裝（和管理）任何官方 Firebase 擴展。

請務必查看 Firebase CLI 和 Firebase 控制台支持的操作之間的差異。

要安裝或管理擴展程序，您必須被分配以下角色之一： Owner 或 Editor或Firebase Admin 。

要安裝擴展，您的項目必須採用Blaze （即用即付）計劃。雖然安裝擴展程序是免費的，但如果您的使用量超出了服務的免費套餐，您可能需要為使用 Firebase 服務或Cloud Secret Manager等雲服務付費。

在你開始之前

如果您尚未將 Firebase 添加到您的項目中，並將您的 Firebase 項目升級到Blaze （即用即付）計劃（如果您尚未這樣做）。

此步驟是可選的，但強烈建議這樣做。

在安裝 Firebase 擴展之前，我們建議您查看有關該擴展的詳細信息，包括：

要查看擴展程序的詳細信息：

在擴展中心瀏覽官方 Firebase 擴展。
單擊分機卡可以：
- 顯示擴展的詳細信息。
- 在Firebase 擴展源存儲庫中查找擴展源代碼的鏈接。
  在擴展的擴展目錄中，您可以在README中查看此詳細信息。

在安裝過程中，系統會提示您查看擴展的基本規範（例如啟用的 API、創建的資源、授予的訪問權限等）。您將收到任何計費要求的通知，並且系統還會提示您指定擴展程序的可配置參數的值。

某些擴展需要您在使用前完成必需或可選的步驟。在 Firebase 控制台的擴展儀表板中的擴展程序安裝後詳細信息頁面中查找這些說明（儀表板的特定鏈接在安裝後顯示在終端中）。

您還可以在擴展源目錄中包含的POSTINSTALL.md文件中找到這些說明。

如果您將擴展程序配置為使用尚不存在的 Firebase 資源（Cloud Firestore 集合、實時數據庫路徑、Cloud Storage 存儲桶），請在使用擴展程序之前創建它們。

當執行期間發生重要事件時，某些擴展會發佈到Eventarc 。如果擴展程序發布事件並且您在安裝過程中啟用了事件，則可以編寫使用您自己的自定義邏輯對這些事件做出反應的函數。這非常有用，例如，可以在長時間運行的任務完成時通知用戶，或者對擴展函數的輸出進行後處理。

請參閱擴展程序的文檔以獲取其發布的事件列表（如果有）。例如，請參閱Run Payments with Stripe 擴展的事件類型。

然後，請參閱自定義事件觸發器以獲取有關編寫 Eventarc 事件處理程序的信息。

您可以在同一項目中多次安裝同一擴展。每個安裝的實例都可以有自己的自定義配置和自己的擴展資源。您可以使用實例 ID來識別和引用每個已安裝的實例，該實例在您的項目中是唯一的。系統將提示您確認或編輯您安裝的擴展的每個附加實例的實例 ID。