Udostępnij za pośrednictwem


Admin - Dashboards GetTilesAsAdmin

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

{
  "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