Apps - Get Report

Hizmet:

Power BI REST APIs

API Sürümü:

v1.0

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

Gerekli Kapsam

Report.ReadWrite.All veya Report.Read.All

Sınırlamalar

Hizmet sorumlusu kimlik doğrulaması desteklenmez.

GET https://api.powerbi.com/v1.0/myorg/apps/{appId}/reports/{reportId}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
appId	path	True	string (uuid)	Uygulama kimliği
reportId	path	True	string (uuid)	Rapor kimliği

Yanıtlar

Name	Tür	Description
200 OK	Report	Tamam

Örnekler

Example

Örnek isteği

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

Örnek yanıt

Durum kodu:

200

{
  "appId": "3d9b93c6-7b6d-4801-a491-1738910904fd",
  "datasetId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "66b2570c-d9d3-40b2-83d9-1095c6700041",
  "name": "SalesMarketing",
  "webUrl": "https://app.powerbi.com/reports/66b2570c-d9d3-40b2-83d9-1095c6700041",
  "embedUrl": "https://app.powerbi.com/reportEmbed?reportId=66b2570c-d9d3-40b2-83d9-1095c6700041&appId=3d9b93c6-7b6d-4801-a491-1738910904fd&config=eyJjbHVzdGVyVXJsIjoiaHR0cHM6Ly9XQUJJLVNPVVRILUNFTlRSQUwtVVMtcmVkaXJlY3QuYW5hbHlzaXMud2luZG93cy5uZXQifQ"
}

Tanımlar

Name	Description
PrincipalType	Asıl tür
Report	Power BI raporu. API, aşağıdaki rapor ö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.
ReportUser	Power BI kullanıcısı bir rapor için doğru girişe erişti
ReportUserAccessRight	Kullanıcının rapor için sahip olduğu erişim hakkı (izin düzeyi)
ServicePrincipalProfile	Power BI hizmet sorumlusu profili. Yalnızca Power BI Embedded çok kiracılı çö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ı

PrincipalType

Numaralandırma

Asıl tür

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

Report

Nesne

Power BI raporu. API, aşağıdaki rapor ö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 rapor bir uygulamaya aitse döndürülen uygulama kimliği
datasetId	string	Raporun veri kümesi kimliği
description	string	Rapor açıklaması
embedUrl	string	Raporun ekleme URL'si
format	string	Rapor tanımı biçim türü. PowerBIReport için: PBIR PBIR-Eski PaginatedReport için: RDL
id	string (uuid)	Rapor kimliği
isOwnedByMe	boolean	Geçerli kullanıcının raporu değiştirme veya raporun bir kopyasını oluşturma yeteneği olup olmadığını gösterir.
name	string	Raporun adı. Uygulama raporları [App] ön eki ile başlar.
originalReportId	string (uuid)	Çalışma alanı bir uygulama olarak yayımlandığında gerçek rapor kimliği.
reportType	enum: PaginatedReport PowerBIReport	Rapor türü
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. Rapor Aboneliklerini Yönetici API çağrısı olarak alma kullanarak Power BI raporu için abonelik bilgilerini alabilirsiniz.
users	ReportUser[]	(Boş değer) Power BI raporu için kullanıcı erişim ayrıntıları. Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Rapor Kullanıcılarını Yönetici olarak Al API çağrısını veya parametresiyle PostWorkspaceInfo getArtifactUsers kullanarak Power BI raporundaki kullanıcı bilgilerini alabilirsiniz.
webUrl	string	Raporun web URL'si

ReportUser

Nesne

Power BI kullanıcısı bir rapor için doğru girişe erişti

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	Asıl tür
profile	ServicePrincipalProfile	Power BI hizmet sorumlusu profili. Yalnızca Power BI Embedded çok kiracılı çözümüiçin geçerlidir.
reportUserAccessRight	ReportUserAccessRight	Kullanıcının rapor için sahip olduğu erişim hakkı (izin düzeyi)
userType	string	Kullanıcının türü.

ReportUserAccessRight

Numaralandırma

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

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

ServicePrincipalProfile

Nesne

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

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

Subscription

Nesne

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 (uuid)	Abone olunan Power BI öğesinin kimliği (rapor veya pano gibi)
artifactType	string	Power BI öğesinin türü (örneğin, Report, Dashboardveya Dataset)
attachmentFormat	string	E-posta aboneliğine eklenen raporun biçimi
endDate	string (date-time)	E-posta aboneliğinin bitiş tarihi ve saati
frequency	string	E-posta aboneliğinin sıklığı
id	string (uuid)	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 mevcut olup olmadığı
startDate	string (date-time)	E-posta aboneliğinin başlangıç tarihi ve saati
subArtifactDisplayName	string	Raporsa abone olunan Power BI öğesinin sayfa adı.
title	string	Uygulama adı
users	SubscriptionUser[]	Her e-posta abonesinin ayrıntıları. Kullanıcı Aboneliklerini Yönetici Olarak Al API çağrısı 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. Rapor Aboneliklerini Yönetici Olarak Al kullanarak veya Pano Aboneliklerini Yönetici Olarak Al API çağrılarını bir Power BI raporu veya panosundaki abonelik bilgilerini alabilirsiniz.

SubscriptionUser

Nesne

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	Asıl tür
profile	ServicePrincipalProfile	Power BI hizmet sorumlusu profili. Yalnızca Power BI Embedded çok kiracılı çözümüiçin geçerlidir.
userType	string	Kullanıcının türü.