Salesforce1 レポート REST API
REST ベースの Salesforce1 レポート API では、Salesforce のレポートデータにプログラムを使用してアクセスできます。
Salesforce1 レポート REST API を使用するケース
Salesforce1 レポート REST API では、レポートビルダーで定義されたレポートデータを Salesforce プラッ��フォーム内外で任意の Web アプリケーションまたはモバイルアプリケーションに統合できます。たとえば、API を使用して、各四半期の最優秀担当者のスナップ写真を掲載した Chatter 投稿をトリガできます。
Salesforce1 レポート API を使用すると、次のことができます。
- レポートデータをカスタムオブジェクトに統合する。
- API の上位にリッチな視覚効果を定義して、データのアニメーションを実行する。
- カスタムダッシュボードを作成する。
- レポートタスクを自動化する。
API リソースでは、概要レベルでレポートデータのクエリおよび絞り込みができます。次の操作を実行できます。
- 表形式レポート、サマリーレポート、またはマトリックスレポートを同期または非同期に実行する。
- 特定のデータをその場で絞り込む。
- レポートメタデータをクエリする。
たとえば、Salesforce1 レポート API の Execute Async REST リソースを使用して、非同期にレポートを実行できます。その場合、次の形式の REST リソース URL を使用します。
POST 要求では、必要なグルーピングと検索条件を示す JSON データを指定します。要求が成功すると、Salesforce はレポートを実行キューに入れ、レポートの状況と結果を取得する場所に関する情報が含まれる、次のような JSON 応答データを返します。
1/services/data/<latest API version>/analytics/reports/<report ID>/instances1{
2
3 "id": "0LGD000000000IjOAI",
4
5 "requestDate": "2013-08-12T18:39:06Z",
6
7 "status": "New",
8
9 "ownerId": "005D0000001KvxRIAS",
10
11 "url": "/services/data/v29.0/analytics/reports/00OD0000001ZbP7MAK/instances/0LGD000000000IjOAI",
12
13 "hasDetailRows": false,
14
15 "completionDate": null
16
17}サポート対象のエディションとプラットフォーム
Salesforce1 レポート API を使用するには、組織で Enterprise Edition、Performance Edition、Unlimited Edition、または Developer Edition を使用する必要があります。既存の Salesforce のお客様が Enterprise Edition、Unlimited Edition、または Performance Edition にアップグレードする場合は、担当者にご連絡ください。