英語で読む

次の方法で共有

Reports - Update Report Content

  • リファレンス
サービス:
Power BI REST APIs
API バージョン:
v1.0

[マイ ワークスペース] から指定したレポートの内容を、指定したソース レポートの内容で更新します。

要求本文でソース レポートを指定します。

必要なスコープ

Report.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/reports/{reportId}/UpdateReportContent

URI パラメーター

名前 / 必須 型 説明
reportId
 path True

string (uuid)

レポート ID

要求本文

名前 必須 型 説明
sourceReport True

SourceReport

既存のソース レポート
sourceType True

sourceType

コンテンツ更新のソースの種類

応答

名前 型 説明
200 OK

Report

わかりました

例

Example

要求のサンプル

POST https://api.powerbi.com/v1.0/myorg/reports/5b218778-e7a5-4d73-8187-f10824047715/UpdateReportContent
要求本文
{
  "sourceReport": {
    "sourceReportId": "8e4d5880-81d6-4804-ab97-054665050799",
    "sourceWorkspaceId": "2f42a406-a075-4a15-bbf2-97ef958c94cb"
  },
  "sourceType": "ExistingReport"
}

応答のサンプル

状態コード:
200

定義

名前 説明
PrincipalType

プリンシパルの種類
Report

Power BI レポート。 この API は、次のレポート プロパティの一覧のサブセットを返します。 サブセットは、呼び出された API、呼び出し元のアクセス許可、および Power BI データベース内のデータの可用性に依存します。
ReportUser

レポートの Power BI ユーザー アクセス権エントリ
ReportUserAccessRight

ユーザーがレポートに対して持っているアクセス権 (アクセス許可レベル)
ServicePrincipalProfile

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

既存のソース レポート
sourceType

コンテンツ更新のソースの種類
Subscription

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

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

レポートの内容を更新するための Power BI 要求

PrincipalType

列挙

プリンシパルの種類

値 説明
App

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

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

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

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

Report

Object

Power BI レポート。 この API は、次のレポート プロパティの一覧のサブセットを返します。 サブセットは、呼び出された API、呼び出し元のアクセス許可、および Power BI データベース内のデータの可用性に依存します。

名前 型 説明
appId

string

レポートがアプリに属している場合にのみ返されるアプリ ID
datasetId

string

レポートのデータセット ID
description

string

レポートの説明
embedUrl

string

レポートの埋め込み URL
id

string (uuid)

レポート ID
isOwnedByMe

boolean

現在のユーザーがレポートのコピーを変更または作成できるかどうかを示します。
name

string

レポートの名前。 アプリ レポートはプレフィックス [App] で始まります。
originalReportId

string (uuid)

ワークスペースがアプリとして発行されたときの実際のレポート ID。
reportType enum:
  • PaginatedReport
  • PowerBIReport

レポートの種類
subscriptions

Subscription[]

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

ReportUser[]

(空の値)Power BI レポートのユーザー アクセスの詳細。 このプロパティは、今後のリリースでペイロードの応答から削除されます。 Power BI レポートのユーザー情報を取得するには、Admin API 呼び出しとしてレポート ユーザーを取得するか、 パラメーターを使用した getArtifactUsers API 呼び出しを使用します。
webUrl

string

レポートの Web URL

ReportUser

Object

レポートの Power BI ユーザー アクセス権エントリ

名前 型 説明
displayName

string

プリンシパルの表示名
emailAddress

string

ユーザーのメール アドレス
graphId

string

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

string

プリンシパルの識別子
principalType

PrincipalType

プリンシパルの種類
profile

ServicePrincipalProfile

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

ReportUserAccessRight

ユーザーがレポートに対して持っているアクセス権 (アクセス許可レベル)
userType

string

ユーザーの種類。

ReportUserAccessRight

列挙

ユーザーがレポートに対して持っているアクセス権 (アクセス許可レベル)

値 説明
None

レポート内のコンテンツに対するアクセス許可がない
Owner

レポート内のコンテンツへの読み取り、書き込み、および再共有アクセスを許可します
Read

レポート内のコンテンツへの読み取りアクセス権を付与します
ReadCopy

レポート内のコンテンツへの読み取りとコピーのアクセス権を付与します
ReadReshare

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

レポート内のコンテンツに対する読み取りと書き込みのアクセス権を付与します

ServicePrincipalProfile

Object

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

名前 型 説明
displayName

string

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

string (uuid)

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

SourceReport

Object

既存のソース レポート

名前 型 説明
sourceReportId

string (uuid)

ソース レポート ID
sourceWorkspaceId

string (uuid)

ソース ワークスペース ID

sourceType

列挙

コンテンツ更新のソースの種類

値 説明
ExistingReport

既存のレポートをターゲット レポートの更新に使用するコンテンツのソースとして使用する

Subscription

Object

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

名前 型 説明
artifactDisplayName

string

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

string (uuid)

サブスクライブした Power BI アイテムの ID (レポートやダッシュボードなど)
artifactType

string

Power BI 項目の種類 (Report、Dashboard、Datasetなど)
attachmentFormat

string

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

string (date-time)

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

string

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

string (uuid)

サブスクリプション ID
isEnabled

boolean

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

boolean

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

boolean

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

string (date-time)

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

string

サブスクライブした Power BI アイテムのページ名 (レポートの場合)。
title

string

アプリ名
users

SubscriptionUser[]

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

SubscriptionUser

Object

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

名前 型 説明
displayName

string

プリンシパルの表示名
emailAddress

string

ユーザーのメール アドレス
graphId

string

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

string

プリンシパルの識別子
principalType

PrincipalType

プリンシパルの種類
profile

ServicePrincipalProfile

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

string

ユーザーの種類。

UpdateReportContentRequest

Object

レポートの内容を更新するための Power BI 要求

名前 型 説明
sourceReport

SourceReport

既存のソース レポート
sourceType

sourceType

コンテンツ更新のソースの種類