メインコンテンツまでスキップ

ダッシュボード・レポート管理 API

最終更新 2026/10/03

呼び出し方法は、Open APIドキュメントの呼び出し方法の説明を参照してください。

関連機能については、まずAE使用マニュアルのダッシュボードの部分を読むことをお勧めします:ダッシュボード

1. レポート管理​

1. Rootアカウントのレポート一覧を照会​

インターフェースURL

/open/manage-reports?token=xxx&projectId=0

リクエストメソッド

GET

Content-Type

application/json

リクエストQueryパラメータ

パラメータ名サンプル値パラメータタイプ必須パラメータの説明
tokenxxxStringはいクエリキー
projectId0IntegerはいプロジェクトID

成功レスポンスの例

{
"data": {
"reports": [
{
"createType": "MANUAL_CREATE",
"dashboardIds": [],
"reportDesc": "",
"reportId": 34214,
"reportModel": 0,
"reportName": "event_3の合計回数(4)",
"updateTime": "2021-02-04 16:44:03"
},
{
"createType": "IMPORTED",
"dashboardIds": [
3015
],
"reportDesc": "",
"reportId": 25565,
"reportModel": 0,
"reportName": "ログイン回数-先月(1)",
"updateTime": "2020-12-18 14:03:32"
}
],
"dashboards": [
{
"dashbord_id": 3015,
"dashbord_name": "パフォーマンステスト"
}
]
},
"return_code": 0,
"return_message": "success"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
data-Objectレスポンスデータ
data.dashboards-Listダッシュボード情報
data.dashboards.dashbord_id1440IntegerダッシュボードID
data.dashboards.dashbord_name条件汎用フィルターダッシュボードStringダッシュボード名
data.reports-Listレポート情報
data.reports.createTypeMANUAL_CREATEString

レポートの作成方法:

  • MANUAL_CREATE:手動作成
  • IMPORTED:ダッシュボードのインポートによる作成
  • COPIED:ダッシュボードのコピーによる作成
data.reports.dashboardIds2378IntegerダッシュボードIDの集合(このレポートに関連するダッシュボードIDのリスト。空の場合、このレポートはどのダッシュボードにも配置されていません)
data.reports.reportDesc-Objectレポートの注釈
data.reports.reportId4049IntegerレポートID
data.reports.reportModel0Integer

分析モデル

  • 0:イベント分析
  • 1:リテンション分析
  • 2:ファネル分析
  • 3:ユーザープロパティ分析
  • 4:フロー分析
  • 5:分布分析
data.reports.reportName直指Stringレポート名
data.reports.updateTime2019-12-20 15:59:44Date更新日時
return_code0Integerリターンコード
return_messagesuccessStringリターンメッセージ

2. プロジェクトのレポート一覧を照会​

インターフェースURL

/open/list-project-reports?token=xxx&projectId=0

リクエストメソッド

GET

Content-Type

application/json

リクエストQueryパラメータ

パラメータ名サンプル値パラメータタイプ必須パラメータの説明
tokenxxxStringはいクエリキー
projectId0IntegerはいプロジェクトID

成功レスポンスの例

{
"data": [
{
"reportId": 34214,
"createType": "MANUAL_CREATE",
"reportDesc": "ここにレポートの説明",
"projectId": 0,
"reportName": "ここにレポート名",
"reportModel": "EVENT",
"creator": {
"openId": "UIODASBJ-Jiodas312",
"loginName": "user1",
"userName": "ユーザー1"
},
"dashboardIds": [
109,
91
]
}
],
"return_code": 0,
"return_message": "success"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
data-Listレスポンスデータ
data.reportId34214LongレポートID
data.reportNameここにレポート名Integerレポート名
data.reportDescここにレポートの説明Stringレポートの説明
data.projectId0IntegerプロジェクトID

data.createType

MANUAL_CREATEString

レポートの作成方法:

  • MANUAL_CREATE:手動作成
  • IMPORTED:インポートによる作成
  • COPIED:コピーによる作成
  • SCENE_CREATE テンプレートに基づく作成
  • PACK_IMPORT プロジェクトのインポートによる作成

data.reportModel

EVENT

String
  • EVENT:イベント分析レポート
  • RETENTION:リテンション分析レポート
  • FUNNEL:ファネル分析レポート
  • PROP_ANALYSIS:プロパティ分析レポート
  • PATH_ANALYSIS:フロー分析レポート
  • SQL:SQLレポート
  • INTERVAL_ANALYSIS:インターバル分析レポート
data.creator-Objectレポート作成者
openIdUIODASBJ-Jiodas312StringopenId
loginNameuser1Stringログインアカウント
userNameユーザー1Stringニックネーム
data.dashboardIds[109, 91]ListダッシュボードID
return_code0Integerリターンコード
return_messagesuccessStringリターンメッセージ

3. レポートの一括削除​

インターフェースURL

/open/report-batch-del?token=xxx&projectId=0

リクエストメソッド

POST

Content-Type

application/json

リクエストQueryパラメータ

パラメータ名サンプル値パラメータタイプ必須パラメータの説明
tokenxxxStringはいクエリキー
projectId0StringはいプロジェクトID

リクエストBodyパラメータ

{
"reportIds": [
34214
]
}
パラメータ名サンプル値パラメータタイプ必須パラメータの説明
reportIds[34214]ListいいえレポートIDリスト

成功レスポンスの例

{
"return_code": 0,
"return_message": "success"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
return_code0Stringリターンコード
return_messagesuccessStringリターンメッセージ

2. ダッシュボード管理​

4. ダッシュボード・レポート管理/ダッシュボードのインポート​

インターフェースURL

/open/import-dashboards?token=xxx&projectId=0&dashboardNameConflictPolicy=RENAME_CREATE&spaceDashboardPolicy=IN_EXISTED_SPACE_OR_CREATE_SPACE

リクエストメソッド

POST

Content-Type

application/json

リクエストQueryパラメータ

パラメータ名サンプル値パラメータタイプ必須パラメータの説明
tokenxxxStringはいクエリキー
projectId0IntegerはいプロジェクトID
dashboardNameConflictPolicyRENAME_CREATEStringはい

ダッシュボード名が競合した場合の処理方針。デフォルト値はRENAME_CREATE

  • RENAME_CREATE:自動で名前を変更
  • SKIP:スキップ
  • REPLACE:置換
spaceDashboardPolicyIN_EXISTED_SPACE_OR_CREATE_SPACEStringはい

共有スペースのダッシュボードの配置方針。デフォルト値はIN_EXISTED_SPACE_OR_CREATE_SPACE

  • CREATE_SPACE:ダッシュボードを新規作成したスペースに配置
  • IN_EXISTED_SPACE_OR_CREATE_SPACE:ダッシュボードを既存の同名スペース、または新規作成したスペースに配置
  • IN_PRIVATE:マイダッシュボードに配置

成功レスポンスの例

{
"data": {
"boardCreateFailed": 1,
"boardCreated": 1,
"boardTotal": 2,
"folderCreated": 1,
"reportCreateFailed": 1,
"reportCreated": 1,
"reportTotal": 2
},
"return_code": 0,
"return_message": "success"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
data-Objectレスポンスデータ
data.boardCreateFailed1Integerダッシュボードの作成失敗数
data.boardCreated1Integerダッシュボードの作成成功数
data.boardTotal2Integerダッシュボードの総数
data.folderCreated1Integerフォルダーの作成数
data.reportCreateFailed1Integerレポートの作成失敗数
data.reportCreated1Integerレポートの作成数
data.reportTotal2Integerレポートの総数
return_code0Integerリターンコード
return_messagesuccessStringリターンメッセージ

エラーレスポンスの例

{
"return_code": -3004,
"return_message": "無効なプロジェクト"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
return_code-3004Stringリターンコード
return_message無効なプロジェクトStringリターンメッセージ

5. スペースのダッシュボードの削除​

注意

ダッシュボードがAPI呼び出し元によって作成されたものである場合は、そのダッシュボードを削除します。それ以外の場合は、ダッシュボードをスペースから作成者のプライベートディレクトリに移動します。

インターフェースURL

/open/delete-dashboard-from-space?token=xxx&projectId=0&dashboardId=1&spaceId=1

リクエストメソッド

POST

Content-Type

application/json

リクエストQueryパラメータ

パラメータ名サンプル値パラメータタイプ必須パラメータの説明
tokenxxxStringはいクエリキー
projectId0IntegerはいプロジェクトID
dashboardId1IntegerはいダッシュボードID
spaceId1IntegerはいスペースID

成功レスポンスの例

{
"return_code": 0,
"return_message": "success"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
return_code0Integerリターンコード
return_messagesuccessStringリターンメッセージ

エラーレスポンスの例

{
"return_code": -1008,
"return_message": "パラメータエラー、dashboard not in space"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
return_code-1008Integerリターンコード
return_messageパラメータエラー、dashboard not in spaceStringリターンメッセージ

3. スペース管理​

6. スペースIDとダッシュボード一覧を照会​

インターフェースURL

/open/get-space-dashboards-by-space-name?token=xxx&projectId=377&spaceName=b

リクエストメソッド

GET

Content-Type

application/json

リクエストQueryパラメータ

パラメータ名サンプル値パラメータタイプ必須パラメータの説明
tokenxxxStringはいクエリキー
projectId377IntegerはいプロジェクトID
spaceNamebStringはいスペース名

成功レスポンスの例

{
"data": {
"dashboards": [
{
"dashbordId": 3590,
"dashbordName": "lzm"
}
],
"spaceId": 31
},
"return_code": 0,
"return_message": "success"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
data-Objectレスポンスデータ
data.dashboards-Listダッシュボード情報
data.dashboards.dashbordId3590IntegerダッシュボードID
data.dashboards.dashbordNamelzmStringダッシュボード名
data.spaceId31IntegerスペースID
return_code0Integerリターンコード
return_messagesuccessStringリターンメッセージ

エラーレスポンスの例

{
"return_code": -1006,
"return_message": "操作する権限がありません(view space dashboards)"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
return_code-1006Integerリターンコード
return_message操作する権限がありません(view space dashboards)Stringリターンメッセージ

7. スペースIDとメンバー権限一覧を照会​

インターフェースURL

/open/get-space-members-by-space-name?token=xxx&projectId=377&spaceName=b

リクエストメソッド

GET

Content-Type

application/json

リクエストQueryパラメータ

パラメータ名サンプル値パラメータタイプ必須パラメータの説明
tokenxxxStringはいクエリキー
projectId377IntegerはいプロジェクトID
spaceNamebStringはいスペース名

成功レスポンスの例

{
"data": {
"allAuthUserAuthority": "MEMBER",
"authUserGroups": [
{
"authority": "ADMIN",
"id": 1301,
"name": "test1"
}
],
"authUsers": [
{
"authority": "ADMIN",
"id": 1149,
"name": "test2"
}
],
"creator": {
"id": 928,
"name": "test3"
},
"spaceId": 31
},
"return_code": 0,
"return_message": "success"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
data-Objectレスポンスデータ
data.allAuthUserAuthorityMEMBERString全メンバーの権限
data.authUserGroups-List権限グループのリスト
data.authUserGroups.authorityADMINString権限
data.authUserGroups.id1301IntegerユーザーID
data.authUserGroups.nametest1Stringユーザー名
data.authUsers-Listユーザーリスト
data.authUsers.authorityADMINString権限
data.authUsers.id1149IntegerユーザーID
data.authUsers.nametest2Stringユーザー名
data.creator-Object作成者情報
data.creator.id928Integer作成者のユーザーID
data.creator.nametest3String作成者の氏名
data.spaceId31IntegerスペースID
return_code0Integerリターンコード
return_messagesuccessStringリターンメッセージ

エラーレスポンスの例

{
"return_code": -1006,
"return_message": "操作する権限がありません(view space members)"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
return_code-1006Integerリターンコード
return_message操作する権限がありません(view space members)Stringリターンメッセージ

8. スペースメンバー権限リストの更新​

スペース名やスペースのデフォルト権限の更新、スペースメンバーの権限の追加・変更、スペースメンバーグループの権限の追加・変更に使用できます

注意

送信したメンバー権限リストで、元のメンバーリスト全体が置き換えられます

インターフェースURL

/open/update-space?token=xxx&projectId=0&spaceId=0

リクエストメソッド

POST

Content-Type

application/json

リクエストQueryパラメータ

パラメータ名サンプル値パラメータタイプ必須パラメータの説明
tokenxxxStringはいクエリキー
projectId0IntegerはいプロジェクトID
spaceId0IntegerはいスペースID

リクエストBodyパラメータ

{
"allAuthUserAuthority": "MEMBER",
"authUserGroups": [
{
"id": 99,
"authority": "MEMBER",
"name": "member99"
}
],
"authUsers": [
{
"id": 88,
"authority": "ADMIN",
"name": "admin88"
}
],
"spaceName": "spaceTest"
}
パラメータ名サンプル値パラメータタイプ必須パラメータの説明
allAuthUserAuthoritystringString

いいえ

全メンバーの権限

  • MEMBER:一般メンバー
  • ADMIN:管理者
authUserGroups-Listいいえユーザーグループリスト
authUserGroups.id99IntegerいいえユーザーグループID
authUserGroups.nameMEMBERStringいいえユーザーグループ名
authUserGroups.authority

member99

String

いいえ

ユーザーグループの権限

  • MEMBER:一般メンバー
  • ADMIN:管理者
authUsers-Listいいえユーザーリスト
authUsers.id88IntegerいいえユーザーID
authUsers.nameADMINStringいいえユーザーの氏名
authUsers.authorityadmin88Stringいいえ

ユーザーの権限

  • MEMBER:一般メンバー
  • ADMIN:管理者
spaceNamespaceTestStringいいえスペース名

成功レスポンスの例

{
"return_code": 0,
"return_message": "success"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
return_code0Integerリターンコード
return_messagesuccessStringリターンメッセージ

エラーレスポンスの例

{
"return_code": -1023,
"return_message": "ダッシュボードスペースが存在しません"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
return_code-1023Integerリターンコード
return_messageダッシュボードスペースが存在しませんStringリターンメッセージ

9. スペースの削除​

インターフェースURL

/open/delete-space?token=xxx&projectId=0&spaceId=1

リクエストメソッド

POST

Content-Type

application/json

リクエストQueryパラメータ

パラメータ名サンプル値パラメータタイプ必須パラメータの説明
tokenxxxStringはいクエリキー
projectId0IntegerはいプロジェクトID
spaceId1IntegerはいスペースID

成功レスポンスの例

{
"return_code": 0,
"return_message": "success"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
return_code0Integerリターンコード
return_messagesuccessStringリターンメッセージ

エラーレスポンスの例

{
"return_code": -1023,
"return_message": "ダッシュボードスペースが存在しません"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
return_code-1023Integerリターンコード
return_messageダッシュボードスペースが存在しませんStringリターンメッセージ

4. ダッシュボードプッシュ​

10. ダッシュボードプッシュの実行​

プッシュ情報を設定済みのダッシュボードであれば、定期プッシュを有効にしているかどうかにかかわらず、APIからプッシュを実行できます。画面で設定したチャネル、内容、スタイル、およびダッシュボード作成者のデータ権限に基づいて、プッシュタスクが即時に実行されます。会社レベルとプロジェクトレベルのtokenのみ使用できます。

インターフェースURL

/open/dashboard/daily-report/exec

リクエストメソッド

POST

Content-Type

application/json

リクエストQueryパラメータ

パラメータ名サンプル値パラメータタイプ必須パラメータの説明
tokenxxxStringはいクエリキー
dashboardId1IntegerはいダッシュボードID
tokenの種類の制限

ダッシュボードプッシュAPIは会社レベルとプロジェクトレベルのtokenでのみ使用でき、個人レベルのtokenには対応していません

成功レスポンスの例

{"return_code": 0,"return_message": "success"}
パラメータ名サンプル値パラメータタイプパラメータの説明
return_code0Integerリターンコード
return_messagesuccessStringリターンメッセージ

エラーレスポンスの例

{"return_code": -1,"return_message": "有効なプッシュチャネルがありません。ダッシュボード-ダッシュボードプッシュで設定してください"}
パラメータ名サンプル値パラメータタイプパラメータの説明
return_code-1Integerリターンコード
return_message有効なプッシュチャネルがありません。ダッシュボード-ダッシュボードプッシュで設定してくださいStringリターンメッセージ
このページは役に立ちましたか?