Admin - Dashboards GetDashboardsInGroupAsAdmin

指定したワークスペースからダッシュボードの一覧を返します。

アクセス許可

  • ユーザーは管理者権限 (Office 365グローバル管理者や Power BI サービス管理者など) を持っているか、サービス プリンシパルを使用して認証する必要があります。
  • 委任されたアクセス許可がサポートされています。

サービス の prinicipal 認証で実行する場合、アプリには、Azure portalで Power BI に対して管理者の同意が必要な事前使用許可が設定されていない必要があります

必要なスコープ

Tenant.Read.All または Tenant.ReadWrite.All

標準の委任された管理者アクセス トークンを使用して認証する場合にのみ関連します。 サービス プリンシパル経由の認証を使用する場合は、存在しない必要があります。

制限事項

1 時間あたり最大 200 要求。

GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/dashboards
GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/dashboards?$filter={$filter}&$top={$top}&$skip={$skip}

URI パラメーター

名前 / 必須 説明
groupId
path True

string

uuid

ワークスペース ID

$filter
query

string

ブール条件に基づいて結果をフィルター処理する

$skip
query

integer

int32

最初の n 個の結果をスキップします

$top
query

integer

int32

最初の n 個の結果のみを返します

応答

名前 説明
200 OK

AdminDashboards

OK

Example

Sample Request

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

Sample Response

{
  "value": [
    {
      "id": "69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
      "displayName": "SalesMarketing",
      "embedUrl": "https://app.powerbi.com/dashboardEmbed?dashboardId=69ffaa6c-b36d-4d01-96f5-1ed67c64d4af&groupId=f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isReadOnly": false
    }
  ]
}

定義

名前 説明
AdminDashboard

管理 API によって返される Power BI ダッシュボード。 API は、次のダッシュボード プロパティの一覧のサブセットを返します。 サブセットは、呼び出される API、呼び出し元のアクセス許可、および Power BI データベース内のデータの可用性に依存します。

AdminDashboards

Power BI ダッシュボード コレクションの OData 応答ラッパー

AdminTile

管理 API によって返される Power BI タイル。

DashboardUser

ダッシュボードの Power BI ユーザー アクセス権エントリ

DashboardUserAccessRight

ユーザーがダッシュボードに対して持っているアクセス権 (アクセス許可レベル)

PrincipalType

プリンシパルの種類

ServicePrincipalProfile

Power BI サービス プリンシパル プロファイル。 マルチテナント ソリューションPower BI Embeddedにのみ関連します。

Subscription

Power BI アイテムのメール サブスクリプション (レポートやダッシュボードなど)

SubscriptionUser

Power BI メール サブスクリプション ユーザー

AdminDashboard

管理 API によって返される Power BI ダッシュボード。 API は、次のダッシュボード プロパティの一覧のサブセットを返します。 サブセットは、呼び出される API、呼び出し元のアクセス許可、および Power BI データベース内のデータの可用性に依存します。

名前 説明
appId

string

ダッシュボードがアプリに属している場合にのみ返されるアプリ ID

displayName

string

ダッシュボードの表示名

embedUrl

string

ダッシュボードの埋め込み URL

id

string

ダッシュボード ID

isReadOnly

boolean

ダッシュボードが読み取り専用かどうか

subscriptions

Subscription[]

(空の値)Power BI アイテム (レポートやダッシュボードなど) のサブスクリプションの詳細。 このプロパティは、今後のリリースでペイロード応答から削除されます。 Power BI レポートのサブスクリプション情報を取得するには、API 呼び出しとしてレポート サブスクリプションの取得管理使用します。

tiles

AdminTile[]

ダッシュボードに属するタイル

users

DashboardUser[]

(空の値)ダッシュボードのユーザー アクセスの詳細。 このプロパティは、今後のリリースでペイロード応答から削除されます。 Power BI ダッシュボードでユーザー情報を取得するには、管理 API 呼び出しとしてダッシュボード ユーザーを取得するか、 パラメーターを指定して PostWorkspaceInfo API 呼び出しをgetArtifactUsers使用します。

webUrl

string

ダッシュボードの Web URL

workspaceId

string

ダッシュボードのワークスペース ID (GUID)。 このプロパティは、GetDashboardsAsAdmin でのみ返されます。

AdminDashboards

Power BI ダッシュボード コレクションの OData 応答ラッパー

名前 説明
odata.context

string

OData コンテキスト

value

AdminDashboard[]

ダッシュボード コレクション

AdminTile

管理 API によって返される Power BI タイル。

名前 説明
colSpan

integer

タイルスパン列の数

datasetId

string

データセット ID。 レポートから作成されたタイル、または Q&A タイルなどのデータセットを使用して作成されたタイルでのみ使用できます。

embedData

string

タイルの埋め込みデータ

embedUrl

string

タイルの埋め込み URL

id

string

タイル ID

reportId

string

レポート ID。 レポートから作成されたタイルでのみ使用できます。

rowSpan

integer

タイルスパン行の数

title

string

タイルの表示名

DashboardUser

ダッシュボードの Power BI ユーザー アクセス権エントリ

名前 説明
dashboardUserAccessRight

DashboardUserAccessRight

ユーザーがダッシュボードに対して持っているアクセス権 (アクセス許可レベル)

displayName

string

プリンシパルの表示名

emailAddress

string

ユーザーの電子メール アドレス

graphId

string

Microsoft Graph のプリンシパルの識別子。 管理者 API でのみ使用できます。

identifier

string

プリンシパルの識別子

principalType

PrincipalType

プリンシパルの種類

profile

ServicePrincipalProfile

Power BI サービス プリンシパル プロファイル。 マルチテナント ソリューションPower BI Embeddedにのみ関連します。

userType

string

ユーザーの種類。

DashboardUserAccessRight

ユーザーがダッシュボードに対して持っているアクセス権 (アクセス許可レベル)

名前 説明
None

string

ダッシュボード内のコンテンツに対するアクセス許可がない

Owner

string

レポート内のコンテンツへの読み取り、書き込み、再共有のアクセス権を付与します

Read

string

ダッシュボード内のコンテンツへの読み取りアクセス権を付与します

ReadCopy

string

ダッシュボード内のコンテンツへの読み取りとコピーのアクセス権を付与します

ReadReshare

string

ダッシュボード内のコンテンツへの読み取りと再共有のアクセス権を付与します

ReadWrite

string

ダッシュボード内のコンテンツへの読み取りと書き込みのアクセス権を付与します

PrincipalType

プリンシパルの種類

名前 説明
App

string

サービス プリンシパルの種類

Group

string

グループ プリンシパルの種類

None

string

プリンシパルの種類はありません。 organization レベルのアクセス全体に使用します。

User

string

ユーザー プリンシパルの種類

ServicePrincipalProfile

Power BI サービス プリンシパル プロファイル。 マルチテナント ソリューションPower BI Embeddedにのみ関連します。

名前 説明
displayName

string

サービス プリンシパル プロファイル名

id

string

サービス プリンシパル プロファイル ID

Subscription

Power BI アイテムのメール サブスクリプション (レポートやダッシュボードなど)

名前 説明
artifactDisplayName

string

サブスクライブされている Power BI アイテムの名前 (レポートやダッシュボードなど)

artifactId

string

サブスクライブされている Power BI アイテムの ID (レポートやダッシュボードなど)

artifactType

string

Power BI 項目の種類 (、、または DatasetなどReportDashboard)

attachmentFormat

string

メール サブスクリプションに添付されているレポートの形式

endDate

string

メール サブスクリプションの終了日時

frequency

string

メール サブスクリプションの頻度

id

string

サブスクリプション ID

isEnabled

boolean

メール サブスクリプションが有効になっているかどうか

linkToContent

boolean

サブスクリプション リンクがメール サブスクリプションに存在するかどうか

previewImage

boolean

レポートのスクリーンショットがメール サブスクリプションに存在するかどうか

startDate

string

メール サブスクリプションの開始日時

subArtifactDisplayName

string

サブスクライブされている Power BI アイテムのページ名 (レポートの場合)。

title

string

アプリの名前

users

SubscriptionUser[]

各メール サブスクライバーの詳細。 Get User Subscriptions As 管理 API 呼び出しを使用する場合、返される値は空の配列 (null) です。 このプロパティは、今後のリリースでペイロード応答から削除されます。 Power BI レポートまたはダッシュボードのサブスクリプション情報を取得するには、[レポート サブスクリプションを管理として取得] または [ダッシュボード サブスクリプションを 管理 API 呼び出しとして取得する] を使用します。

SubscriptionUser

Power BI メール サブスクリプション ユーザー

名前 説明
displayName

string

プリンシパルの表示名

emailAddress

string

ユーザーの電子メール アドレス

graphId

string

Microsoft Graph のプリンシパルの識別子。 管理者 API でのみ使用できます。

identifier

string

プリンシパルの識別子

principalType

PrincipalType

プリンシパルの種類

profile

ServicePrincipalProfile

Power BI サービス プリンシパル プロファイル。 マルチテナント ソリューションPower BI Embeddedにのみ関連します。

userType

string

ユーザーの種類。