Admin - Dashboards GetTilesAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Zwraca listę kafelków w ramach określonego pulpitu nawigacyjnego.

Uprawnienia

• Użytkownik musi mieć uprawnienia administratora (takie jak administrator globalny Office 365 lub administrator usługi Power BI) lub uwierzytelnić się przy użyciu jednostki usługi.
• Uprawnienia delegowane są obsługiwane.

W przypadku uruchamiania w ramach uwierzytelniania podstawowego usługi aplikacja nie może mieć żadnych premii wymaganych przez administratora dla usługi Power BI ustawionych w Azure Portal.

Zakres wymagany

Tenant.Read.All lub Tenant.ReadWrite.All

Istotne tylko w przypadku uwierzytelniania za pośrednictwem standardowego delegowanego tokenu dostępu administratora. Nie może być obecny, gdy jest używane uwierzytelnianie za pośrednictwem jednostki usługi.

Ograniczenia

Maksymalna liczba żądań na godzinę wynosi 200.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
dashboardId	path	True	string uuid	Identyfikator pulpitu nawigacyjnego

Odpowiedzi

Nazwa	Typ	Opis
200 OK	AdminTiles	OK

Przykłady

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"
    }
  ]
}

Definicje

Nazwa	Opis
AdminTile	Kafelek usługi Power BI zwrócony przez interfejsy API Administracja.
AdminTiles	Otoka odpowiedzi OData dla kolekcji kafelków usługi Power BI

AdminTile

Kafelek usługi Power BI zwrócony przez interfejsy API Administracja.

Nazwa	Typ	Opis
colSpan	integer	Liczba kolumn obejmujących kafelek
datasetId	string	Identyfikator zestawu danych. Dostępne tylko dla kafelków utworzonych na podstawie raportu lub przy użyciu zestawu danych, takiego jak kafelki Q&A.
embedData	string	Dane osadzania dla kafelka
embedUrl	string	Adres URL osadzania kafelka
id	string	Identyfikator kafelka
reportId	string	Identyfikator raportu. Dostępne tylko dla kafelków utworzonych na podstawie raportu.
rowSpan	integer	Liczba kafelków obejmuje wiersze
title	string	Nazwa wyświetlana kafelka

AdminTiles

Otoka odpowiedzi OData dla kolekcji kafelków usługi Power BI

Nazwa	Typ	Opis
odata.context	string	Kontekst OData
value	AdminTile[]	Kolekcja kafelków