Embed Token - Generate Token

リファレンス

サービス:: Power BI REST APIs

API バージョン:: v1.0

複数のレポート、データセット、およびターゲットワークスペースの埋め込みトークンを生成します。

レポートとデータセットを関連付ける必要はありません。
埋め込み中にレポートをデータセットにバインドできます。
targetWorkspaces パラメーターで指定されたワークスペースでのみレポートを作成できます。

重要

この API 呼び出しは、顧客シナリオの埋め込みにのみ関連します。この API の使用方法の詳細については、「埋め込みトークンを生成するときのの考慮事項」を参照してください。

権限

認証にサービスプリンシパルを使用する場合は、「サービスプリンシパルのを使用して Power BI コンテンツを埋め込む」との考慮事項と制限事項を参照してください。
ページ分割されたビジュアルを含む Power BI レポートの場合は、API 呼び出しにページ分割されたレポート ID を含めます。詳細については、例を参照してください。
この API 呼び出しは、サービスプリンシパルプロファイルによって呼び出すことができます。詳細については、「Power BI Embeddedでのサービスプリンシパルプロファイルの」を参照してください。

必要なスコープ

要件が適用されない場合を除き、次のすべてを行います。

Content.Create。ターゲットワークスペースが GenerateTokenRequestV2 で指定場合に必要です。
Report.ReadWrite.All または Report.Read.All。GenerateTokenRequestV2 でレポート指定されている場合に必要です。
Report.ReadWrite.All。GenerateTokenRequestV2 で少なくとも 1 つのレポートに allowEdit フラグが指定されている場合必要です。
Dataset.ReadWrite.All または Dataset.Read.All

制限事項

targetWorkspaces パラメーターで指定されたワークスペースでのみレポートを作成できます。
すべてのレポートとデータセットは、V2 ワークスペースに存在する必要があります。
すべてのターゲットワークスペースは、V2 ワークスペース する必要があります。
最大 50 個のレポート。
最大 50 個のデータセット。
最大 50 個のターゲットワークスペース。
Azure Analysis Services または Analysis Services オンプレミスのライブ接続レポートの場合、行レベルセキュリティ (RLS) を使用して埋め込みトークンを生成すると、が再バインドされた後、数分は機能しない場合があります。

POST https://api.powerbi.com/v1.0/myorg/GenerateToken

要求本文

名前	型	説明
datasets	GenerateTokenRequestV2Dataset[]	データセットの一覧
datasourceIdentities	DatasourceIdentity[]	シングル Sign-On (SSO) が有効になっているデータソースに接続するときに使用する ID の一覧。
identities	EffectiveIdentity[]	行レベルのセキュリティ規則に使用する ID の一覧
lifetimeInMinutes	integer	トークンの最大有効期間 (生成時刻から開始) (分単位)。トークンの有効期限を短縮するために使用できますが、それを拡張することはできません。値は正の整数である必要があります。 0 (`0`) は `null`に相当し、既定の有効期限を設定します。
reports	GenerateTokenRequestV2Report[]	レポートの一覧
targetWorkspaces	GenerateTokenRequestV2TargetWorkspace[]	埋め込みトークンで保存できるワークスペースの一覧

応答

名前	型	説明
200 OK	EmbedToken	わかりました

例

Example of generating an embed token for a dataset and two reports example. Only one of the reports can be edited.

Example of generating an embed token for a paginated report which has a Power BI dataset as a datasource. The ID of the dataset must be specified in the request. The report and dataset can each have its own identity

Example of generating an embed token for a paginated report with a data source identity

Example of generating an embed token for a paginated report with multiple data source identities and a single identity blob

Example of generating an embed token for a paginated report with multiple data source identities and multiple identity blobs

Example of generating an embed token for a Power BI report with a dataset which is connected with DirectQuery to another Power BI dataset. All related dataset IDs must be specified in the request with 'xmlaPermissions' set to 'ReadOnly'. IdentityBlobs for all SSO-enabled data sources must be provided in the 'datasourceIdentities' array

Example of generating an embed token for a Power BI report with a paginated visual. The paginated report ID ('...4850') of the paginated visual must be included in the 'reports' section of the request.

Example of generating an embed token for two datasets with RLS identities and a single report with read-only permissions. The embed token lets you view the report, which is dynamically bound to two different datasets.

Example of generating an embed token that expires no later than ten minutes from the API call

Example of generating an embed token for a dataset and two reports example. Only one of the reports can be edited.

要求のサンプル

POST https://api.powerbi.com/v1.0/myorg/GenerateToken

要求本文

{
  "datasets": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ],
  "reports": [
    {
      "allowEdit": true,
      "id": "b2e49b01-2356-4456-bfb9-3f4c2bc4ddbd"
    },
    {
      "id": "759908bb-ead8-4a43-9645-7ffbf921c68d"
    }
  ]
}

応答のサンプル

状態コード:: 200

{
  "token": "H4sI....AAA=",
  "tokenId": "49ae3742-54c0-4c29-af52-619ff93b5c80",
  "expiration": "2018-07-29T17:58:19Z"
}

Example of generating an embed token for a paginated report which has a Power BI dataset as a datasource. The ID of the dataset must be specified in the request. The report and dataset can each have its own identity

要求のサンプル

POST https://api.powerbi.com/v1.0/myorg/GenerateToken

要求本文

{
  "datasets": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "xmlaPermissions": "ReadOnly"
    }
  ],
  "reports": [
    {
      "id": "b2e49b01-2356-4456-bfb9-3f4c2bc4ddbd"
    }
  ],
  "identities": [
    {
      "username": "john@contoso.com",
      "roles": [
        "sales"
      ],
      "datasets": [
        "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
      ]
    },
    {
      "username": "john@contoso.com",
      "reports": [
        "b2e49b01-2356-4456-bfb9-3f4c2bc4ddbd"
      ]
    }
  ]
}

応答のサンプル

状態コード:: 200

{
  "token": "H4sI....AAA=",
  "tokenId": "49ae3742-54c0-4c29-af52-619ff93b5c80",
  "expiration": "2028-07-29T17:58:19Z"
}

Example of generating an embed token for a paginated report with a data source identity

要求のサンプル

POST https://api.powerbi.com/v1.0/myorg/GenerateToken

要求本文

{
  "reports": [
    {
      "id": "b2e49b01-2356-4456-bfb9-3f4c2bc4ddbd"
    }
  ],
  "datasourceIdentities": [
    {
      "datasources": [
        {
          "datasourceType": "Sql",
          "connectionDetails": {
            "server": "New-Sql-Server",
            "database": "New-Sql-Database"
          }
        }
      ],
      "identityBlob": "eyJ0eX....AAA="
    }
  ]
}

応答のサンプル

状態コード:: 200

{
  "token": "H4sI....AAA=",
  "tokenId": "49ae3742-54c0-4c29-af52-619ff93b5c80",
  "expiration": "2028-07-29T17:58:19Z"
}

Example of generating an embed token for a paginated report with multiple data source identities and a single identity blob

要求のサンプル

POST https://api.powerbi.com/v1.0/myorg/GenerateToken

要求本文

{
  "reports": [
    {
      "id": "b2e49b01-2356-4456-bfb9-3f4c2bc4ddbd"
    }
  ],
  "datasourceIdentities": [
    {
      "datasources": [
        {
          "datasourceType": "Sql",
          "connectionDetails": {
            "server": "New-Sql-Server",
            "database": "New-Sql-Database"
          }
        },
        {
          "datasourceType": "MySql",
          "connectionDetails": {
            "server": "New-MySql-Server",
            "database": "New-MySql-Database"
          }
        }
      ],
      "identityBlob": "eyJ0eX....AAA="
    }
  ]
}

応答のサンプル

状態コード:: 200

{
  "token": "H4sI....AAA=",
  "tokenId": "49ae3742-54c0-4c29-af52-619ff93b5c80",
  "expiration": "2028-07-29T17:58:19Z"
}

Example of generating an embed token for a paginated report with multiple data source identities and multiple identity blobs

要求のサンプル

POST https://api.powerbi.com/v1.0/myorg/GenerateToken

要求本文

{
  "reports": [
    {
      "id": "b2e49b01-2356-4456-bfb9-3f4c2bc4ddbd"
    }
  ],
  "datasourceIdentities": [
    {
      "datasources": [
        {
          "datasourceType": "Sql",
          "connectionDetails": {
            "server": "New-Sql-Server",
            "database": "New-Sql-Database"
          }
        }
      ],
      "identityBlob": "eyJ0eX....AAA="
    },
    {
      "datasources": [
        {
          "datasourceType": "MySql",
          "connectionDetails": {
            "server": "New-MySql-Server",
            "database": "New-MySql-Database"
          }
        }
      ],
      "identityBlob": "eyJ0dW....AAA="
    }
  ]
}

応答のサンプル

状態コード:: 200

{
  "token": "H4sI....AAA=",
  "tokenId": "49ae3742-54c0-4c29-af52-619ff93b5c80",
  "expiration": "2028-07-29T17:58:19Z"
}

要求のサンプル

POST https://api.powerbi.com/v1.0/myorg/GenerateToken

要求本文

{
  "datasets": [
    {
      "id": "b2e49b01-2356-4456-bfb9-3f4c2bc4ddbd",
      "xmlaPermissions": "ReadOnly"
    },
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "xmlaPermissions": "ReadOnly"
    }
  ],
  "reports": [
    {
      "id": "f904e89a-7ebe-4aa0-8647-e409063b4850"
    }
  ],
  "datasourceIdentities": [
    {
      "datasources": [
        {
          "datasourceType": "Sql",
          "connectionDetails": {
            "server": "Best-Sql-Server",
            "database": "Database3"
          }
        }
      ],
      "identityBlob": "eyJ0eX....AAA="
    }
  ]
}

応答のサンプル

状態コード:: 200

{
  "token": "H4sI....AAA=",
  "tokenId": "ab4d49ae-c054-4c29-af52-93b5c80619ff",
  "expiration": "2022-06-10T12:41:11Z"
}

Example of generating an embed token for a Power BI report with a paginated visual. The paginated report ID ('...4850') of the paginated visual must be included in the 'reports' section of the request.

要求のサンプル

POST https://api.powerbi.com/v1.0/myorg/GenerateToken

要求本文

{
  "datasets": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ],
  "reports": [
    {
      "id": "b2e49b01-2356-4456-bfb9-3f4c2bc4ddbd"
    },
    {
      "id": "f904e89a-7ebe-4aa0-8647-e409063b4850"
    }
  ]
}

応答のサンプル

状態コード:: 200

{
  "token": "H4sI....AAA=",
  "tokenId": "49ae3742-54c0-4c29-af52-619ff93b5c80",
  "expiration": "2018-07-29T17:58:19Z"
}

Example of generating an embed token for two datasets with RLS identities and a single report with read-only permissions. The embed token lets you view the report, which is dynamically bound to two different datasets.

要求のサンプル

POST https://api.powerbi.com/v1.0/myorg/GenerateToken

要求本文

{
  "datasets": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    },
    {
      "id": "e75afc47-1150-45e0-aba7-4eb04e4876e5"
    }
  ],
  "reports": [
    {
      "id": "b2e49b01-2356-4456-bfb9-3f4c2bc4ddbd"
    }
  ],
  "identities": [
    {
      "username": "john@contoso.com",
      "roles": [
        "sales"
      ],
      "datasets": [
        "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
      ]
    },
    {
      "username": "iris@contoso.com",
      "roles": [
        "executive"
      ],
      "datasets": [
        "e75afc47-1150-45e0-aba7-4eb04e4876e5"
      ]
    }
  ]
}

応答のサンプル

状態コード:: 200

{
  "token": "H4sI....AAA=",
  "tokenId": "4b76f5ed-5a06-4150-8d1b-60f8e4c186f4",
  "expiration": "2028-07-29T17:58:19Z"
}

Example of generating an embed token that expires no later than ten minutes from the API call

要求のサンプル

POST https://api.powerbi.com/v1.0/myorg/GenerateToken

要求本文

{
  "datasets": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ],
  "reports": [
    {
      "id": "b2e49b01-2356-4456-bfb9-3f4c2bc4ddbd"
    }
  ],
  "identities": [
    {
      "username": "john@contoso.com",
      "roles": [
        "sales"
      ],
      "datasets": [
        "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
      ]
    }
  ],
  "lifetimeInMinutes": 10
}

応答のサンプル

状態コード:: 200

{
  "token": "H4sI....AAA=",
  "tokenId": "4b76f5ed-5a06-4150-8d1b-60f8e4c186f4",
  "expiration": "2028-07-29T17:58:19Z"
}

定義

名前	説明
DatasourceConnectionDetails	Power BI データソース接続の詳細。「データソースの取得」または「グループでデータソースを取得」の例を参照してください。
DatasourceIdentity	シングルサインオン (SSO) が有効になっている DirectQuery データソースを接続するための有効な ID。
DatasourceSelector	接続の詳細によって 1 つのデータソースを一意に識別するオブジェクト。
EffectiveIdentity	ユーザー ID とロールを定義します。詳細については、「Power BI Embeddedを使用した行レベルのセキュリティ」を参照してください。
EmbedToken	Power BI 埋め込みトークン
GenerateTokenRequestV2	Power BI のトークン生成要求 V2
GenerateTokenRequestV2Dataset	GenerateTokenRequestV2 内のデータセットオブジェクト
GenerateTokenRequestV2Report	GenerateTokenRequestV2 のレポートオブジェクト
GenerateTokenRequestV2TargetWorkspace	GenerateTokenRequestV2 内のワークスペースオブジェクト
IdentityBlob	ID を指定するための BLOB。 Azure SQL への DirectQuery 接続を持つデータセットでのみサポートされます
XmlaPermissions	XMLA のアクセス許可

DatasourceConnectionDetails

Object

Power BI データソース接続の詳細。「データソースの取得」または「グループでデータソースを取得」の例を参照してください。

名前	型	説明
account	string	接続アカウント
classInfo	string	接続クラス情報
database	string	接続データベース
domain	string	接続ドメイン
emailAddress	string	接続メールアドレス
kind	string	接続の種類
loginServer	string	接続ログインサーバー
path	string	接続パス
server	string	接続サーバー
url	string	接続 URL

DatasourceIdentity

Object

シングルサインオン (SSO) が有効になっている DirectQuery データソースを接続するための有効な ID。

名前	型	説明
datasources	DatasourceSelector[]	この ID が適用されるデータソースの配列。
identityBlob	string	ID を指定するための BLOB。

DatasourceSelector

Object

接続の詳細によって 1 つのデータソースを一意に識別するオブジェクト。

名前

型

説明

connectionDetails

DatasourceConnectionDetails

データソース接続の詳細。ページ分割されたレポートのデータソースの取得を使用して接続の詳細を取得し、powerbi レポート API のデータソースを取得できます。

datasourceType

string

データソースの型。

データソースの API 名
ActiveDirectory	AdobeAnalytics	AdoDotNet
AnalysisServices	AzureBlobs	AzureDataLakeStorage
AzureMarketplace	AzureTables	BizTalk
CDPA	CustomConnector	CustomHttpApi
DB2	Essbase	EventHub
エクセル	交換	拡張
Facebook	ファイル	フォルダー
GoogleAnalytics	Hdfs	HDInsight
Informix	MQ	MySql
OData	ODBC	OleDb
オラクル	PostgreSQL	PowerQueryMashup
PubNub	セールスフォース	SAPBW
SAPBWMessageServer	SapErp	SAPHana
SharePoint	SharePointDocLib	SharePointList
SQL (構造化クエリ言語)	Sybase	Teradata
UIFlow	ウェブ

EffectiveIdentity

Object

ユーザー ID とロールを定義します。詳細については、「Power BI Embeddedを使用した行レベルのセキュリティ」を参照してください。

名前	型	説明
auditableContext	string	EffectiveIdentity 監査可能なコンテキスト。このパラメーターが指定され、空でない場合は、EffectiveIdentity の監査が有効になり、その値は監査レコードのユーザー名に設定されます。それ以外の場合、EffectiveIdentity コンテキストは GenerateToken 監査レコードから省略されます。
customData	string	行レベルのセキュリティ規則の適用に使用されるカスタムデータ。 Azure Analysis Services モデルとクラウドモデルへのライブ接続でのみサポートされます。
datasets	string[]	この ID が適用されるデータセットの配列
identityBlob	IdentityBlob	IDを指定する BLOB。 Azure SQL への DirectQuery 接続を持つデータセットでのみサポートされます。
reports	string[]	この ID が適用されるレポートの配列。ページ分割されたレポートでのみサポートされます。
roles	string[]	RLS ルールを適用するトークン内の行レベルセキュリティ (RLS) ロールの配列。 ID には、最大 50 個のロールを含めることができます。ロールには、`,`を除く任意の文字を含めることができます。その長さは 50 文字を超えてはなりません。
username	string	行レベルのセキュリティ規則を適用するトークン内の有効なユーザー名。オンプレミスモデルの場合、ユーザー名には、英数字、または次のいずれかの文字 `.`、`-`、`_`、`!`、`#`、`^`、`~`、`\\`、`@`を含めることができます。クラウドモデルの場合、ユーザー名には任意の ASCII 文字を含めることができます。どちらのモデルでも、ユーザー名の長さは 256 文字を超えてはなりません。また、ユーザー名にはスペースを含めてはなりません。

EmbedToken

Object

Power BI 埋め込みトークン

名前	型	説明
expiration	string (date-time)	トークンの有効期限の日付と時刻 (UTC)
token	string	埋め込みトークン
tokenId	string (uuid)	一意のトークン ID。監査ログを使用すると、トークン ID を使用して、トークンを使用する操作を生成操作と関連付けることができます。

GenerateTokenRequestV2

Object

Power BI のトークン生成要求 V2

名前	型	説明
datasets	GenerateTokenRequestV2Dataset[]	データセットの一覧
datasourceIdentities	DatasourceIdentity[]	シングル Sign-On (SSO) が有効になっているデータソースに接続するときに使用する ID の一覧。
identities	EffectiveIdentity[]	行レベルのセキュリティ規則に使用する ID の一覧
lifetimeInMinutes	integer	トークンの最大有効期間 (生成時刻から開始) (分単位)。トークンの有効期限を短縮するために使用できますが、それを拡張することはできません。値は正の整数である必要があります。 0 (`0`) は `null`に相当し、既定の有効期限を設定します。
reports	GenerateTokenRequestV2Report[]	レポートの一覧
targetWorkspaces	GenerateTokenRequestV2TargetWorkspace[]	埋め込みトークンで保存できるワークスペースの一覧

GenerateTokenRequestV2Dataset

Object

GenerateTokenRequestV2 内のデータセットオブジェクト

名前	型	説明
id	string	データセット ID
xmlaPermissions	XmlaPermissions	XMLA のアクセス許可

GenerateTokenRequestV2Report

Object

GenerateTokenRequestV2 のレポートオブジェクト

名前	型	説明
allowEdit	boolean	生成された埋め込みトークンがレポートの編集をサポートしているかどうか
id	string (uuid)	レポート ID

GenerateTokenRequestV2TargetWorkspace

Object

GenerateTokenRequestV2 内のワークスペースオブジェクト

名前	型	説明
id	string (uuid)	ワークスペース ID

IdentityBlob

Object

ID を指定するための BLOB。 Azure SQL への DirectQuery 接続を持つデータセットでのみサポートされます

名前	型	説明
value	string	Azure SQL の OAuth 2.0 アクセストークン

XmlaPermissions

列挙

XMLA のアクセス許可

値	説明
Off	生成された埋め込みトークンが、データセットの XMLA エンドポイントへのアクセス許可を付与しないことを示します。
ReadOnly	生成された埋め込みトークンが、データセットの XMLA エンドポイントに対する読み取りアクセス許可を付与することを示します。

次の方法で共有

Embed Token - Generate Token

権限

必要なスコープ

制限事項

要求本文

応答

例

Example of generating an embed token for a dataset and two reports example. Only one of the reports can be edited.

要求のサンプル

応答のサンプル

Example of generating an embed token for a paginated report which has a Power BI dataset as a datasource. The ID of the dataset must be specified in the request. The report and dataset can each have its own identity

要求のサンプル

応答のサンプル

Example of generating an embed token for a paginated report with a data source identity

要求のサンプル

応答のサンプル

Example of generating an embed token for a paginated report with multiple data source identities and a single identity blob

要求のサンプル

応答のサンプル

Example of generating an embed token for a paginated report with multiple data source identities and multiple identity blobs

要求のサンプル

応答のサンプル

要求のサンプル

応答のサンプル

Example of generating an embed token for a Power BI report with a paginated visual. The paginated report ID ('...4850') of the paginated visual must be included in the 'reports' section of the request.

要求のサンプル

応答のサンプル

Example of generating an embed token for two datasets with RLS identities and a single report with read-only permissions. The embed token lets you view the report, which is dynamically bound to two different datasets.

要求のサンプル

応答のサンプル

Example of generating an embed token that expires no later than ten minutes from the API call

要求のサンプル

応答のサンプル

定義

DatasourceConnectionDetails

DatasourceIdentity

DatasourceSelector

EffectiveIdentity

EmbedToken

GenerateTokenRequestV2

GenerateTokenRequestV2Dataset

GenerateTokenRequestV2Report

GenerateTokenRequestV2TargetWorkspace

IdentityBlob

XmlaPermissions