Dashboards - Get Tile In Group

从指定的工作区返回指定仪表板中的指定磁贴。

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

权限

此 API 调用可由服务主体配置文件调用。 有关详细信息,请参阅:Power BI Embedded中的服务主体配置文件。

所需范围

Dashboard.ReadWrite.All 或 Dashboard.Read.All

局限性

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

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

URI 参数

名称 必需 类型 说明
dashboardId
path True

string (uuid)

仪表板 ID

groupId
path True

string (uuid)

工作区 ID

tileId
path True

string (uuid)

磁贴 ID

响应

名称 类型 说明
200 OK

Tile

还行

示例

Example

示例请求

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dashboards/69ffaa6c-b36d-4d01-96f5-1ed67c64d4af/tiles/312fbfe9-2eda-44e0-9ed0-ab5dc571bb4b

示例响应

{
  "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&groupId=f089354e-8366-4e18-aea3-4cb4a3a50b48",
  "rowSpan": 0,
  "colSpan": 0,
  "reportId": "5b218778-e7a5-4d73-8187-f10824047715",
  "datasetId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
}

定义

Tile

Power BI 磁贴

名称 类型 说明
colSpan

integer

平铺跨列数

datasetId

string

数据集 ID。 仅适用于从报表创建的磁贴或使用数据集(如 Q&A 磁贴)。

embedData

string

磁贴的嵌入数据

embedUrl

string

磁贴的嵌入 URL

id

string (uuid)

磁贴 ID

reportId

string (uuid)

报表 ID。 仅适用于从报表创建的磁贴。

rowSpan

integer

平铺跨行数

title

string

磁贴的显示名称