We are excited to announce the release of a new feature in our Cloud Analytics API, allowing you to have greater flexibility and control over your report time ranges. You can now include an optional timeRange parameter in your report.get() API method requests, providing a more precise way to fetch data for custom periods.

Key Features:

1. Include an optional timeRange parameter in the report.get() API method.
2. Specify the time range by providing either a duration or a startDate/endDate pair.

The backend will utilize the provided time range instead of the one set in the report itself.

Examples:

• For duration-based time range: https://api.doit.com/analytics/v1/reports/{replace-with-report-id}&timeRange=P20D
• For a specific time range, use startDate and endDate: https://api.doit.com/analytics/v1/reports/{replace-with-report-id}&startDate=2022-08-15&endDate=2022-09-03

Duration Format:

Durations are represented in the format P[n]Y[n]M[n]D[n], where [n] is replaced by the value for each date and time element.

• P: Duration designator (for period) placed at the start of the duration representation.
• Y: Year designator that follows the value for the number of calendar years.
• M: Month designator that follows the value for the number of calendar months.
• W: Week designator that follows the value for the number of weeks.
• D: Day designator that follows the value for the number of calendar days.

We hope this new feature empowers you to better manage and analyze your data by offering greater control over the time ranges in your reports. Be sure to try it, and let us know your feedback!