Chapter 17: Analytics API
data containing information on where to get the report status and results, that might look something like this: { "id": "0LGD000000000IjOAI", "requestDate": "2013-08-12T18:39:06Z", "status": "New", "ownerId": "005D0000001KvxRIAS", "url": "/services/data/v29.0/analytics/reports/00OD0000001ZbP7MAK/instances/0LGD000000000IjOAI", "hasDetailRows": false, "completionDate": null }
Supported Editions and Platforms To use Analytics API, your organization must use Enterprise Edition, Performance Edition, Unlimited Edition, or Developer Edition. If you are an existing Salesforce customer and want to upgrade to Enterprise, Unlimited, or Performance Edition, contact your account representative.
Best Practices Consider the best practices explained in this section.
Use JSON for Request and Response Data Analytics API supports request and response data in JSON, and not in XML. While using the Analytics API with a request body, use Content-Type: application/json in your request headers.
Analytics API Limits Analytics API has the following limitations: • • • • • • •
222
Cross filters, standard report filters, and filtering by row limit are unavailable when filtering data. Historical trend reports in tabular format are unavailable. The API can process only reports that contain up to 100 fields selected as columns. The List resource returns up to 200 reports that the API user recently viewed. Your organization can request as many as 500 synchronous report runs per hour through the Execute Sync resource. The API supports as many as 20 synchronous report run requests at a time. The Instances List resource returns up to 2000 instances of a report that was run asynchronously.