Wave REST API 開発者ガイド
jWave REST API リソースの概要
Wave REST API は、Wave Analytics データにアクセスするためのリソースを提供します。
すべての Wave REST API リソースには、以下を使用してアクセスします。
- 会社の基本 URI (https://yourInstance.salesforce.com など)
- バージョン情報 (/services/data/v37.0 など)
- 名前付きリソース (/wave など)
1hhttps://yourInstance.salesforce.com/services/data/v37.0/wave| リソース | 説明 | サポートされている HTTP メソッド | リソース URL |
|---|---|---|---|
| Wave リソース | Wave Analytics で使用できる最上位のリソースをリストします。 | GET | /wave |
| Query リソース | Salesforce Analytics Query Language (SAQL) で記述されたクエリを実行します。 | POST | /wave/query |
| Datasets List リソース | Wave Analytics データセットのリストを返します。 | GET | /wave/datasets |
| Dataset リソース | 指定された ID を持つ Wave Analytics データセットを返すか、データセットを削除 (DELETE) するか、データセットを更新 (PATCH) します。 | GET、DELETE、PATCH | /wave/datasets/<dataset ID> |
| Versions List リソース | 特定のデータセットのデータセットバージョンのコレクションを返します。 | GET | /wave/datasets/<dataset ID>/versions |
| Version リソース | Wave Analytics データセットのバージョンを返す (GET) か、述語を更新 (PATCH) します。 | GET、PATCH | /wave/datasets/<dataset ID>/versions/<version ID> |
| File リソース | データセットファイルのバイナリコンテンツへのアクセスを提供します。 | GET | /wave/datasets/<dataset ID>/versions/<version ID> /files/<file ID> |
| XMD List リソース | データセットのバージョンの XMD リソースのリストを返します。 | GET | /wave/datasets/<dataset ID>/versions/<version ID>/xmds |
| XMD リソース | データセットのバージョンの拡張メタデータ (XMD) を返し (GET)、ユーザ XMD ファイルを置き換えます (PUT)。 | GET、PUT | /wave/datasets/<dataset ID>/versions/<version ID>/xmds/<XMD type> |
| Lenses List リソース | Wave Analytics レンズのリストを返す (GET) か、レンズを作成 (POST) します。 | GET、POST | /wave/lenses |
| Lens リソース | 指定された ID を持つ Wave Analytics レンズの構造が記述されている JSON ファイルを返す (GET) か、レンズを削除 (DELETE) するか、レンズを更新 (PATCH) します。 | GET、DELETE、POST | /wave/lenses/<lens ID> |
| Lens File リソース | Wave Analytics レンズに含まれるファイルを返します。 | GET、PUT | /wave/lenses/<lenses ID>/files/<files ID> |
| Dashboards List リソース | Wave Analytics ダッシュボードのリストを返すか、ダッシュボードを作成します。 | GET、POST | /wave/dashboards |
| Dashboard リソース | 指定された ID を持つ Wave Analytics ダッシュボードを返したり更新したりします。 | GET、DELETE、PATCH | /wave/dashboards/<dashboard ID> |
| Dependencies リソース | アプリケーション (フォルダ) の連動関係を返します。 | GET | /wave/dependencies/<folder ID> |
| Folders List リソース | Wave データセット、レンズ、ダッシュボードが含まれるフォルダである Wave Analytics アプリケーションを作成 (POST) するか、アプリケーションまたはフォルダのコレクションを返します (GET)。 | GET、POST | /wave/folders |
| Folder リソース | Wave Analytics アプリケーションまたはフォルダの表現を返す (GET) か、アプリケーションまたはフォルダを置換 (PUT) するか、更新 (PATCH) するか、削除 (DELETE) します。 | GET、PUT、PATCH、DELETE | /wave/folders/<folder ID> |
| Templates List リソース | Wave Analytics テンプレートのリストを返します。 | GET | /wave/templates |
| Templates リソース | Wave Analytics テンプレートのリストを返します。 | GET | /wave/templates/<templateIdOrApiName> |
| Templates Configuration リソース | Wave Analytics テンプレートの設定を返します。 | GET | /wave/templates/<templateIdOrApiName>/configuration |
| Lens File Metadata リソース | Wave レンズファイルのメタデータを管理するためのリソース。 | GET、POST | /wave/lenses/<lensId>/files |
| Features Configuration リソース | ユーザが使用できる Wave 機能です。 | GET | /wave/config/features |
| Annotations List リソース | アノテーションのコレクションです。 | GET、POST | /wave/annotations |
| Annotations リソース | アセットのアノテーションです。 | GET、PATCH | /wave/annotations/<Annotation ID> |
| Template Release Notes リソース | 1 つの Wave Analytics テンプレートのリリースノートを取得するリソースです。 | GET | /wave/templates/<templateIdOrApiName>/releasenotes |
REST 応答の絞り込み
Wave Analytics アプリケーションまたはフォルダの表現を返す (GET) か、アプリケーションまたはフォルダを置換 (PUT) するか、更新 (PATCH) するか、削除 (DELETE) します。
Wave REST API 入力パラメータに加え、Chatter REST API 入力パラメータを使用して、filterGroup、external、および internal 要求から返された結果を絞り込むことができます。詳細は、『Chatter REST API 開発者ガイド』の「応答サイズの指定」を参照してください。