教學課程：針對國家/地區雲端將 Power BI 內容內嵌到您的應用程式中

了解如何在國家/地區雲端的商務程序應用程式內內嵌分析內容。 使用 Power BI .NET SDK 搭配 Power BI JavaScript API 將報表、儀表板或圖格內嵌至 Web 應用程式。

Power BI 支援下列國家/地區雲端：

• 美國政府社群雲端 (GCC)

• 美國政府社群雲端 High (GCC High)

• 美國軍事承包商 (DoDCON)

• 美國軍事 (DoD)

• 適用於中國雲端的 Power BI

若要開始使用此逐步解說，您需要一個 Power BI 帳戶。 如未設定帳戶，根據政府類型或國家/地區，您可以選擇適合您的國家/地區雲端。 註冊以取得一個美國政府 Power BI 帳戶，或一個適用於中國雲端的 Power BI 帳戶。

注意

您是否希望改為您的組織內嵌儀表板？ 請參閱將儀表板整合到您組織的應用程式中。

若要將儀表板整合到 Web 應用程式，請使用 Power BI API 和 Microsoft Entra 授權存取權杖，以取得儀表板。 使用內嵌權杖載入儀表板。 Power BI API 可讓您以程式設計方式存取特定的 Power BI 資源。 如需詳細資訊，請參閱 Power BI REST API、Power BI .NET SDK 及 Power BI JavaScript API。

下載範例

本文顯示了 GitHub 上的應用程式擁有資料範例的程式碼。 若要依照本逐步解說進行，請下載範例。 我們會使用 .NET Framework/Embed for your customers 目錄。

重要

您只能使用 Microsoft 365 SKU 內嵌來自政府社群雲端 (GCC) 的 Power BI 內容。 其他國家/地區雲端的客戶可以使用 Microsoft 365 或 Azure SKU。

• 政府社群雲端 (GCC)：

  1. 在 Web.config 檔案中，更新 applicationId(原生應用程式 applicationId)、workspaceId、使用者名稱 (您的主要使用者) 和密碼。

  2. 接下來，新增 GCC 參數，如下所示。

     <add key="authorityUrl" value="https://login.microsoftonline.com/organizations/" />
     <add key="scopeBase" value="https://analysis.usgovcloudapi.net/powerbi/api/.default" />
     <add key="urlPowerBiServiceApiRoot" value="https://api.powerbigov.us/" />
     

• 軍事承包商 (DoDCON)：

  1. 在 Web.config 檔案中，更新 applicationId(原生應用程式 applicationId)、workspaceId、使用者名稱 (您的主要使用者) 和密碼。

  2. 接下來，新增 DoDCON 參數，如下所示。

     <add key="authorityUrl" value="https://login.microsoftonline.us/organizations/" />
     <add key="scopeBase" value="https://high.analysis.usgovcloudapi.net/powerbi/api/.default" />
     <add key="urlPowerBiServiceApiRoot" value="https://api.high.powerbigov.us/" />
     

• 軍事 (DoD)：

  1. 在 Web.config 檔案中，更新 applicationId(原生應用程式 applicationId)、workspaceId、使用者名稱 (您的主要使用者) 和密碼。

  2. 接下來，新增 DoDCON 參數，如下所示。

     <add key="authorityUrl" value="https://login.microsoftonline.us/organizations/" />
     <add key="scopeBase" value="https://mil.analysis.usgovcloudapi.net/powerbi/api/.default" />
     <add key="urlPowerBiServiceApiRoot" value="https://api.mil.powerbigov.us/" />
     

• 適用於中國雲端的 Power BI 參數

  1. 在 Web.config 檔案中，更新 applicationId(原生應用程式 applicationId)、workspaceId、使用者名稱 (您的主要使用者) 和密碼。

  2. 接下來，新增適用於中國雲端的 Power BI 參數，如下所示。

     <add key="authorityUrl" value="https://login.chinacloudapi.cn/organizations/" />
     <add key="scopeBase" value="https://analysis.chinacloudapi.cn/powerbi/api/.default" />
     <add key="urlPowerBiServiceApiRoot" value="https://api.powerbi.cn/" />
     

步驟 1 - 在 Microsoft Entra ID 中註冊應用程式

在 Microsoft Entra ID 中註冊應用程式以進行 REST API 呼叫。 如需詳細資訊，請參閱註冊 Microsoft Entra 應用程式以內嵌 Power BI 內容。 因為有不同的國家/地區雲端從屬關係，所以有不同的 URL 來註冊您的應用程式。

• 政府社群雲端 (GCC)： https://app.powerbigov.us/apps

• 軍事承包商 (DoDCON)： https://app.high.powerbigov.us/apps

• 軍事 (DoD)： https://app.mil.powerbigov.us/apps

• 適用於中國雲端的 Power BI - https://app.powerbi.cn/apps

若您已下載對您的客戶進行內嵌範例，就能使用您取得的 applicationId，以便該範例可以向 Microsoft Entra ID 進行驗證。 若要設定範例，請在 web.config 檔案中變更 applicationId。

步驟 2 - 從 Microsoft Entra ID 取得存取權杖

在您的應用程式中，您需要從 Microsoft Entra ID 取得一個存取權杖，然後才能呼叫 Power BI REST API。 如需詳細資訊，請參閱驗證使用者並為 Power BI 應用程式取得 Microsoft Entra 存取權杖。 因為有不同的國家/地區雲端從屬關係，所以有不同的 URL 來取得您應用程式的存取權杖。

• 政府社群雲端 (GCC)： https://login.microsoftonline.com

• 軍事承包商 (DoDCON)： https://login.microsoftonline.us

• 軍事 (DoD)： https://login.microsoftonline.us

• 適用於中國雲端的 Power BI - https://login.chinacloudapi.cn

您可以在 Controllers\HomeController.cs 檔案的每個內容項目工作中看到這些存取權杖範例。

步驟 3 - 內嵌內容

現在您擁有存取權杖，您可以像在任何其他平台上一樣繼續內嵌。

• 內嵌客戶的內容
• 內嵌組織的內容

相關內容

• 對您的客戶進行內嵌範例
• Power BI JavaScript API

更多問題嗎？ 詢問 Power BI 社群