Admin - Dashboards GetTilesAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

指定したダッシュボード内のタイルの一覧を返します。

アクセス許可

• ユーザーは管理者権限 (Office 365グローバル管理者や Power BI サービス管理者など) を持っているか、サービス プリンシパルを使用して認証する必要があります。
• 委任されたアクセス許可がサポートされています。

サービス の prinicipal 認証で実行する場合、アプリは、Azure portalで Power BI に対して管理者の同意が必要な使用許可を設定する必要はありません。

必要なスコープ

Tenant.Read.All または Tenant.ReadWrite.All

標準の委任された管理者アクセス トークンを使用して認証する場合にのみ関連します。 サービス プリンシパルによる認証を使用する場合は、存在しない必要があります。

制限事項

1 時間あたり最大 200 要求。

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards/{dashboardId}/tiles

URI パラメーター

名前	/	必須	型	説明
dashboardId	path	True	string uuid	ダッシュボード ID

応答

名前	型	説明
200 OK	AdminTiles	OK

例

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards/69ffaa6c-b36d-4d01-96f5-1ed67c64d4af/tiles

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "312fbfe9-2eda-44e0-9ed0-ab5dc571bb4b",
      "title": "SalesMarketingTile",
      "embedUrl": "https://app.powerbi.com/embed?dashboardId=69ffaa6c-b36d-4d01-96f5-1ed67c64d4af&tileId=312fbfe9-2eda-44e0-9ed0-ab5dc571bb4b",
      "rowSpan": 0,
      "colSpan": 0,
      "reportId": "5b218778-e7a5-4d73-8187-f10824047715",
      "datasetId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ]
}

定義

名前	説明
AdminTile	管理 API によって返される Power BI タイル。
AdminTiles	Power BI タイル コレクションの OData 応答ラッパー

AdminTile

管理 API によって返される Power BI タイル。

名前	型	説明
colSpan	integer	タイルスパン列の数
datasetId	string	データセット ID。 レポートから作成されたタイル、または Q&A タイルなどのデータセットを使用して作成されたタイルでのみ使用できます。
embedData	string	タイルの埋め込みデータ
embedUrl	string	タイルの埋め込み URL
id	string	タイル ID
reportId	string	レポート ID。 レポートから作成されたタイルでのみ使用できます。
rowSpan	integer	タイルスパン行の数
title	string	タイルの表示名

AdminTiles

Power BI タイル コレクションの OData 応答ラッパー

名前	型	説明
odata.context	string	OData コンテキスト
value	AdminTile[]	タイル コレクション