Apps - Get Dashboard

Başvuru

Hizmet:: Power BI REST APIs

API Sürümü:: v1.0

Belirtilen uygulamadan belirtilen panoyu döndürür.

Gerekli Kapsam

Dashboard.ReadWrite.All veya Dashboard.Read.All

Sınırlamalar

Hizmet sorumlusu kimlik doğrulaması desteklenmez.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
appId	path	True	string uuid	Uygulama kimliği
dashboardId	path	True	string uuid	Pano kimliği

Yanıtlar

Name	Tür	Description
200 OK	Dashboard	Tamam

Örnekler

Example

Örnek isteği

GET https://api.powerbi.com/v1.0/myorg/apps/3d9b93c6-7b6d-4801-a491-1738910904fd/dashboards/{dashboardId}

Örnek yanıt

Durum kodu:: 200

{
  "appId": "3d9b93c6-7b6d-4801-a491-1738910904fd",
  "id": "03dac094-2ff8-47e8-b2b9-dedbbc4d22ac",
  "displayName": "SalesMarketing",
  "embedUrl": "https://app.powerbi.com/dashboardEmbed?dashboardId=335aee4b-7b38-48fd-9e2f-306c3fd67482&appId=3d9b93c6-7b6d-4801-a491-1738910904fd&config=eyJjbHVzdGVyVXJsIjoiaHR0cHM6Ly9XQUJJLVNPVVRILUNFTlRSQUwtVVMtcmVkaXJlY3QuYW5hbHlzaXMud2luZG93cy5uZXQifQ%3d%3d",
  "isReadOnly": false
}

Tanımlar

Name	Description
Dashboard	Power BI panosu. API, aşağıdaki pano özellikleri listesinin bir alt kümesini döndürür. Alt küme, çağrılan API'ye, çağıran izinlerine ve Power BI veritabanındaki verilerin kullanılabilirliğine bağlıdır.
DashboardUser	Bir pano için Power BI kullanıcı erişim hakkı girdisi
DashboardUserAccessRight	Kullanıcının pano için sahip olduğu erişim hakkı (izin düzeyi)
PrincipalType	Sorumlu türü
ServicePrincipalProfile	Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.
Subscription	Power BI öğesi (rapor veya pano gibi) için e-posta aboneliği
SubscriptionUser	Power BI e-posta aboneliği kullanıcısı

Dashboard

Object

Power BI panosu. API, aşağıdaki pano özellikleri listesinin bir alt kümesini döndürür. Alt küme, çağrılan API'ye, çağıran izinlerine ve Power BI veritabanındaki verilerin kullanılabilirliğine bağlıdır.

Name	Tür	Description
appId	string	Yalnızca pano bir uygulamaya aitse döndürülen uygulama kimliği
displayName	string	Panonun görünen adı
embedUrl	string	Panonun ekleme URL'si
id	string	Pano kimliği
isReadOnly	boolean	Panonun salt okunur olup olmadığı
subscriptions	Subscription[]	(Boş Değer) Bir Power BI öğesinin (rapor veya pano gibi) abonelik ayrıntıları. Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Yönetici API çağrısı olarak Rapor Aboneliklerini Al'ı kullanarak bir Power BI raporunun abonelik bilgilerini alabilirsiniz.
users	DashboardUser[]	(Boş değer) Pano kullanıcısı erişim ayrıntıları. Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Power BI panosundaki kullanıcı bilgilerini almak için Pano Kullanıcılarını Yönetici API çağrısı olarak alma veya PostWorkspaceInfo API çağrısı ile parametresini `getArtifactUsers` kullanabilirsiniz.
webUrl	string	Panonun web URL'si

DashboardUser

Object

Bir pano için Power BI kullanıcı erişim hakkı girdisi

Name	Tür	Description
dashboardUserAccessRight	DashboardUserAccessRight	Kullanıcının pano için sahip olduğu erişim hakkı (izin düzeyi)
displayName	string	Sorumlunun görünen adı
emailAddress	string	Kullanıcının e-posta adresi
graphId	string	Microsoft Graph'ta sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir.
identifier	string	Sorumlunun tanımlayıcısı
principalType	PrincipalType	Sorumlu türü
profile	ServicePrincipalProfile	Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.
userType	string	Kullanıcının türü.

DashboardUserAccessRight

Enumeration

Kullanıcının pano için sahip olduğu erişim hakkı (izin düzeyi)

Değer	Description
None	Panodaki içeriğe izin yok
Owner	Rapordaki içeriğe Okuma, Yazma ve Yeniden Paylaşma erişimi verir
Read	Panodaki içeriğe Okuma erişimi verir
ReadCopy	Panodaki içeriğe Okuma ve Kopyalama erişimi verir
ReadReshare	Panodaki içeriğe Okuma ve Yeniden Paylaşma erişimi verir
ReadWrite	Panodaki içeriğe Okuma ve Yazma erişimi verir

PrincipalType

Enumeration

Sorumlu türü

Değer	Description
App	Hizmet sorumlusu türü
Group	Grup sorumlusu türü
None	Sorumlu türü yok. Tüm kuruluş düzeyinde erişim için kullanın.
User	Kullanıcı asıl türü

ServicePrincipalProfile

Object

Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.

Name	Tür	Description
displayName	string	Hizmet sorumlusu profil adı
id	string	Hizmet sorumlusu profil kimliği

Subscription

Object

Power BI öğesi (rapor veya pano gibi) için e-posta aboneliği

Name	Tür	Description
artifactDisplayName	string	Abone olunan Power BI öğesinin adı (rapor veya pano gibi)
artifactId	string	Abone olunan Power BI öğesinin kimliği (rapor veya pano gibi)
artifactType	string	Power BI öğesinin türü (örneğin `Report`, , `Dashboard`veya `Dataset`)
attachmentFormat	string	E-posta aboneliğine eklenen raporun biçimi
endDate	string	E-posta aboneliğinin bitiş tarihi ve saati
frequency	string	E-posta aboneliğinin sıklığı
id	string	Abonelik kimliği
isEnabled	boolean	E-posta aboneliğinin etkinleştirilip etkinleştirilmediği
linkToContent	boolean	E-posta aboneliğinde abonelik bağlantısı olup olmadığı
previewImage	boolean	Raporun ekran görüntüsünün e-posta aboneliğinde olup olmadığı
startDate	string	E-posta aboneliğinin başlangıç tarihi ve saati
subArtifactDisplayName	string	Bir raporsa abone olunan Power BI öğesinin sayfa adı.
title	string	Uygulama adı
users	SubscriptionUser[]	Her e-posta abonesinin ayrıntıları. Api çağrısını Yönetici Olarak Kullanıcı Aboneliklerini Al kullanıldığında, döndürülen değer boş bir dizidir (null). Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Bir Power BI raporu veya panosundaki abonelik bilgilerini almak için Rapor Aboneliklerini Yönetici Olarak Al veya Pano Aboneliklerini Yönetici API çağrıları olarak al'ı kullanabilirsiniz.

SubscriptionUser

Object

Power BI e-posta aboneliği kullanıcısı

Name	Tür	Description
displayName	string	Sorumlunun görünen adı
emailAddress	string	Kullanıcının e-posta adresi
graphId	string	Microsoft Graph'ta sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir.
identifier	string	Sorumlunun tanımlayıcısı
principalType	PrincipalType	Sorumlu türü
profile	ServicePrincipalProfile	Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.
userType	string	Kullanıcının türü.

Aracılığıyla paylaş

Apps - Get Dashboard

Gerekli Kapsam

Sınırlamalar

URI Parametreleri

Yanıtlar

Örnekler

Example

Örnek isteği

Örnek yanıt

Tanımlar

Dashboard

DashboardUser

DashboardUserAccessRight

PrincipalType

ServicePrincipalProfile

Subscription

SubscriptionUser

Ek kaynaklar