Dashboards - Get Tiles

Service:

Power BI REST APIs

API Version:

v1.0

从“我的工作区”返回指定仪表板内的磁贴列表。

支持的磁贴包括数据集和包含整个报表页的动态磁贴。

必需范围

Dashboard.ReadWrite.All 或 Dashboard.Read.All

限制

不会返回在将视觉对象添加到仪表板之前在报表中编辑的标题。 若要返回这些标题，请在仪表板中编辑它们。

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

URI 参数

名称	在	必需	类型	说明
dashboardId	path	True	string uuid	仪表板 ID

响应

名称	类型	说明
200 OK	Tiles	确定

示例

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/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"
    }
  ]
}

定义

名称	说明
Tile	Power BI 磁贴
Tiles	Power BI 磁贴集合的 OData 响应包装器

Tile

Power BI 磁贴

名称	类型	说明
colSpan	integer	磁贴范围列数
datasetId	string	数据集 ID。 仅适用于从报表或使用数据集创建的磁贴，例如 Q&A 磁贴。
embedData	string	磁贴的嵌入数据
embedUrl	string	磁贴的嵌入 URL
id	string	磁贴 ID
reportId	string	报表 ID。 仅适用于从报表创建的磁贴。
rowSpan	integer	磁贴跨行数
title	string	磁贴的显示名称

Tiles

Power BI 磁贴集合的 OData 响应包装器

名称	类型	说明
odata.context	string	OData 上下文
value	Tile[]	磁贴集合