Bagikan melalui

Reports - Get Reports In Group

  • Referensi
Layanan:
Power BI REST APIs
Versi API:
v1.0

Mengembalikan daftar laporan dari ruang kerja yang ditentukan.

Karena laporan paginated (RDL) tidak memiliki himpunan data, nilai ID himpunan data dalam respons API untuk laporan paginated tidak ditampilkan.

Hak akses

Panggilan API ini dapat dipanggil oleh profil perwakilan layanan. Untuk informasi selengkapnya lihat: profil perwakilan layanan di Power BI Embedded.

Cakupan yang Diperlukan

Report.ReadWrite.All atau Report.Read.All 

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/reports

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
groupId
 path True

string (uuid)

ID ruang kerja

Respons

Nama Jenis Deskripsi
200 OK

Reports

OK

Contoh

Example

Permintaan sampel

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/reports

Respon sampel

Kode status:
200 
{
  "value": [
    {
      "datasetId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "id": "5b218778-e7a5-4d73-8187-f10824047715",
      "name": "SalesMarketing",
      "webUrl": "https://app.powerbi.com/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/reports/5b218778-e7a5-4d73-8187-f10824047715",
      "embedUrl": "https://app.powerbi.com/reportEmbed?reportId=5b218778-e7a5-4d73-8187-f10824047715&groupId=f089354e-8366-4e18-aea3-4cb4a3a50b48"
    }
  ]
}

Definisi

Nama Deskripsi
PrincipalType

Jenis utama
Report

Laporan Power BI. API mengembalikan subset dari daftar properti laporan berikut. Subset bergantung pada API yang dipanggil, izin pemanggil, dan ketersediaan data di database Power BI.
Reports

Pembungkus respons OData untuk kumpulan laporan Power BI
ReportUser

Entri kanan akses pengguna Power BI untuk laporan
ReportUserAccessRight

Hak akses yang dimiliki pengguna untuk laporan (tingkat izin)
ServicePrincipalProfile

Profil perwakilan layanan Power BI. Hanya relevan untuk solusi multi-penyewa Power BI Embedded.
Subscription

Langganan email untuk item Power BI (seperti laporan atau dasbor)
SubscriptionUser

Pengguna langganan email Power BI

PrincipalType

Enumeration

Jenis utama

Nilai Deskripsi
App

Jenis perwakilan layanan
Group

Jenis prinsipal grup
None

Tidak ada jenis utama. Gunakan untuk seluruh akses tingkat organisasi.
User

Jenis prinsipal pengguna

Report

Objek

Laporan Power BI. API mengembalikan subset dari daftar properti laporan berikut. Subset bergantung pada API yang dipanggil, izin pemanggil, dan ketersediaan data di database Power BI.

Nama Jenis Deskripsi
appId

string

ID aplikasi, dikembalikan hanya jika laporan milik aplikasi
datasetId

string

ID himpunan data laporan
description

string

Deskripsi laporan
embedUrl

string

URL laporan yang disematkan
id

string (uuid)

ID laporan
isOwnedByMe

boolean

Menunjukkan apakah pengguna saat ini memiliki kemampuan untuk memodifikasi atau membuat salinan laporan.
name

string

Nama laporannya. Laporan aplikasi dimulai dengan awalan [Aplikasi].
originalReportId

string (uuid)

ID laporan aktual saat ruang kerja diterbitkan sebagai aplikasi.
reportType enum:
  • PaginatedReport
  • PowerBIReport

Jenis laporan
subscriptions

Subscription[]

(Nilai Kosong) Detail langganan untuk item Power BI (seperti laporan atau dasbor). Properti ini akan dihapus dari respons payload dalam rilis mendatang. Anda dapat mengambil informasi langganan untuk laporan Power BI dengan menggunakan Dapatkan Langganan Laporan sebagai admin panggilan API.
users

ReportUser[]

(Nilai kosong) Detail akses pengguna untuk laporan Power BI. Properti ini akan dihapus dari respons payload dalam rilis mendatang. Anda dapat mengambil informasi pengguna pada laporan Power BI dengan menggunakan panggilan Dapatkan Pengguna Laporan sebagai Admin API, atau panggilan PostWorkspaceInfo API dengan parameter getArtifactUsers.
webUrl

string

URL web laporan

Reports

Objek

Pembungkus respons OData untuk kumpulan laporan Power BI

Nama Jenis Deskripsi
@odata.context

string

Konteks OData
value

Report[]

Kumpulan laporan

ReportUser

Objek

Entri kanan akses pengguna Power BI untuk laporan

Nama Jenis Deskripsi
displayName

string

Nama tampilan prinsipal
emailAddress

string

Alamat email pengguna
graphId

string

Pengidentifikasi prinsipal di Microsoft Graph. Hanya tersedia untuk API admin.
identifier

string

Pengidentifikasi utama
principalType

PrincipalType

Jenis utama
profile

ServicePrincipalProfile

Profil perwakilan layanan Power BI. Hanya relevan untuk solusi multi-penyewa Power BI Embedded.
reportUserAccessRight

ReportUserAccessRight

Hak akses yang dimiliki pengguna untuk laporan (tingkat izin)
userType

string

Jenis pengguna.

ReportUserAccessRight

Enumeration

Hak akses yang dimiliki pengguna untuk laporan (tingkat izin)

Nilai Deskripsi
None

Tidak ada izin untuk konten dalam laporan
Owner

Memberikan akses Baca, Tulis, dan Buat Ulang ke konten dalam laporan
Read

Memberikan akses Baca ke konten dalam laporan
ReadCopy

Memberikan akses Baca dan Salin ke konten dalam laporan
ReadReshare

Memberikan akses Baca dan Reshare ke konten dalam laporan
ReadWrite

Memberikan akses Baca dan Tulis ke konten dalam laporan

ServicePrincipalProfile

Objek

Profil perwakilan layanan Power BI. Hanya relevan untuk solusi multi-penyewa Power BI Embedded.

Nama Jenis Deskripsi
displayName

string

Nama profil perwakilan layanan
id

string (uuid)

ID profil perwakilan layanan

Subscription

Objek

Langganan email untuk item Power BI (seperti laporan atau dasbor)

Nama Jenis Deskripsi
artifactDisplayName

string

Nama item Power BI langganan (seperti laporan atau dasbor)
artifactId

string (uuid)

ID item Power BI langganan (seperti laporan atau dasbor)
artifactType

string

Jenis item Power BI (misalnya Report, Dashboard, atau Dataset)
attachmentFormat

string

Format laporan yang dilampirkan dalam langganan email
endDate

string (date-time)

Tanggal dan waktu akhir langganan email
frequency

string

Frekuensi langganan email
id

string (uuid)

ID langganan
isEnabled

boolean

Apakah langganan email diaktifkan
linkToContent

boolean

Apakah tautan langganan ada di langganan email
previewImage

boolean

Apakah cuplikan layar laporan ada di langganan email
startDate

string (date-time)

Tanggal dan waktu mulai langganan email
subArtifactDisplayName

string

Nama halaman item Power BI langganan, jika itu adalah laporan.
title

string

Nama aplikasi
users

SubscriptionUser[]

Detail setiap pelanggan email. Saat menggunakan panggilan Dapatkan Langganan Pengguna Sebagai Admin API, nilai yang dikembalikan adalah array kosong (null). Properti ini akan dihapus dari respons payload dalam rilis mendatang. Anda bisa mengambil informasi langganan pada laporan atau dasbor Power BI dengan menggunakan Dapatkan Langganan Laporan Sebagai Admin atau Dapatkan Langganan Dasbor Sebagai admin panggilan API.

SubscriptionUser

Objek

Pengguna langganan email Power BI

Nama Jenis Deskripsi
displayName

string

Nama tampilan prinsipal
emailAddress

string

Alamat email pengguna
graphId

string

Pengidentifikasi prinsipal di Microsoft Graph. Hanya tersedia untuk API admin.
identifier

string

Pengidentifikasi utama
principalType

PrincipalType

Jenis utama
profile

ServicePrincipalProfile

Profil perwakilan layanan Power BI. Hanya relevan untuk solusi multi-penyewa Power BI Embedded.
userType

string

Jenis pengguna.