Power BI で埋め込みEmbedding with Power BI

Power BI には、ダッシュボードとレポートをアプリケーションに埋め込むための API があります。Power BI offers APIs for embedding your dashboards and reports into applications. Power BI API では、一貫性のある一連の機能を利用し、コンテンツを埋め込むときにダッシュボード、ゲートウェイ、アプリ ワークスペースなどの最新の Power BI 機能にアクセスできます。The Power BI APIs offer a consistent set of capabilities and access to the latest Power BI features – such as dashboards, gateways and app workspaces – when embedding content.

単一の APIA single API

Power BI コンテンツを埋め込む主なシナリオは 2 つあります。There are two main scenarios when embedding Power BI content. 組織内の (Power BI のライセンスを所有している) ユーザー向けの埋め込みと、Power BI ライセンスを所有する必要がないユーザーおよび顧客向けの埋め込みです。Embedding for users in your organization (who have licenses for Power BI) and embedding for your users and customers without requiring them to have Power BI licenses. Power BI REST API は両方のシナリオに対応します。The Power BI REST API allows for both scenarios.

Power BI ライセンスのない顧客やユーザーの場合、同じ API を使用して、組織用と顧客用のダッシュボードやレポートをカスタム アプリケーションに埋め込むことができます。For customers and users without Power BI licenses, you can embed dashboards and reports into your custom application, using the same API to either service your organization or your customers. 顧客は、アプリケーションで管理されているデータを参照します。Your customers see the data that is managed by the application. 組織内の Power BI ユーザーの場合は、埋め込みアプリケーションのコンテキストまたは Power BI で直接独自のデータ を表示するための追加オプションが提供されます。And for Power BI users in your organization, they'll have the additional options to view their own data directly in Power BI or in the context of the embedded application. 埋め込みのニーズに合わせて JavaScript や REST API を最大限に活用できます。You can take full advantage of the JavaScript and REST APIs for your embedding needs.

埋め込みの動作のサンプルについては、JavaScript 埋め込みサンプルをご覧ください。To view a sample of how embedding works, see the JavaScript embed sample.

組織向けの埋め込みEmbedding for your organization

組織向けの埋め込みを使って、Power BI サービスを拡張することができます。Embedding for your organization allows you to extend the Power BI service. その場合、コンテンツを表示する際に、アプリケーションのユーザーは Power BI サービスにサインインする必要があります。This requires that users of your application sign into the Power BI service when they want to view their content. サインインした組織のユーザーは、自分が所有しているか、あるいは Power BI サービスで共有されているダッシュボードとレポートにのみアクセスできます。Once someone in your organization signs in, they will only have access to dashboards and reports that they own or that have been shared with them in the Power BI service.

組織向けの埋め込みの例としては、内部の Web アプリケーション、SharePoint Online の Web パーツと Microsoft Teams の統合などがあります。Examples of embedding for your organization include internal web application, the SharePoint Online web part and Microsoft Teams integration.

組織向けの埋め込みについては、以下をご覧ください。For embedding for your organization, see the following:

編集や保存などのセルフサービス機能は、Power BI ユーザー向けの埋め込みの際に JavaScript API を介して使用できます。Self-service capabilities, such as edit, save and more, are available through the JavaScript API when embedding for Power BI users.

顧客向けの埋め込みEmbedding for your customers

顧客向けの埋め込みでは、Power BI のアカウントがないユーザーのためにダッシュボードとレポートを埋め込むことができます。Embedding for your customers provides the ability to embed dashboards and reports to users who don't have an account for Power BI. 顧客は Power BI について何も知る必要はありません。Your customers don't need to know anything about Power BI. 埋め込みアプリケーションを作成するには、少なくとも 1 つの Power BI Pro アカウントが必要です。At least one Power BI Pro account is needed to create an embedded application. Power BI Pro アカウントは、アプリケーションのマスター アカウントとして機能します。The Power BI Pro account acts as a master account for your application. これをプロキシ アカウントと見なします。Think of this as a proxy account. Power BI Pro アカウントを使用して、アプリケーションが所有/管理する Power BI サービス内のダッシュボードとレポートにアクセスできる埋め込みトークンも生成できます。The Power BI Pro account also allows you to generate embed tokens that provide access to dashboards and reports within the Power BI service that are owned/managed by your application.

顧客向けの埋め込みの例としては、他の企業に販売される ISV アプリケーションなどがあります。An example of embedding for your customers is an ISV application being sold to other companies.

顧客向けの埋め込みの埋め込みフロー

ダッシュボード、レポート、およびタイルを埋め込むには、組織向けの埋め込みで使用するのと同じ API を使用します。To embed dashboards, reports and tiles, you would use the same APIs that you would use for embedding for your organization.

重要

埋め込みが Power BI サービスに依存する場合でも、顧客が Power BI に依存することはありません。While embedding has a dependency on the Power BI service, there is not a dependency on Power BI for your customers. ユーザーは、アプリケーションに埋め込まれたコンテンツを表示するために Power BI にサインアップする必要はありません。They do not need to sign up for Power BI to view the embedded content in your application.

運用環境に移行する準備ができたら、アプリ ワークスペースを容量に割り当てる必要があります。When you are ready to move to production, your app workspace must be assigned to a capacity. Microsoft Azure 内の Power BI Embedded が、アプリケーションで使う容量を提供します。Power BI Embedded, within Microsoft Azure, offers capacity to use with your applications.

埋め込み方法の詳細については、「Power BI ダッシュボード、レポート、およびタイルを埋め込む方法」を参照してください。For details on how to embed, see How to embed your Power BI dashboards, reports and tiles.

Azure で Power BI ワークスペース コレクション サービスを使っていた場合、コンテンツを移行する方法については、「Power BI に Power BI Embedded ワークスペース コレクション コンテンツを移行する方法」を参照してください。If you were using the Power BI Workspace Collections service within Azure, see Migrate content from the Power BI Workspace Collections Azure service for information on how to migrate your content over.

次の手順Next steps

Power BI ダッシュボード、レポート、およびタイルを埋め込む方法How to embed your Power BI dashboards, reports and tiles
Power BI に Power BI Embedded ワークスペース コレクション コンテンツを移行する方法How to migrate Power BI Embedded workspace collection content to Power BI
Power BI Premium とはPower BI Premium - what is it?
JavaScript API Git リポジトリJavaScript API Git repo
Power BI C# Git リポジトリPower BI C# Git repo
JavaScript 埋め込みサンプルJavaScript embed sample
埋め込み分析の容量計画に関するホワイト ペーパーEmbedded analytics capacity planning whitepaper
Power BI Premium ホワイト ペーパーPower BI Premium whitepaper

他にわからないことがある場合は、More questions? Power BI コミュニティで質問してみてくださいTry asking the Power BI Community