The Campaign Manager 360 API provides several ways to retrieve data for ads trafficked
through Campaign Manager 360.

## Reports service

Generating reports using the [`Reports`](https://developers.google.com/doubleclick-advertisers/current/reports) service
involves a multi-step workflow to configure, generate, and retrieve report files
(such as CSV or Excel format). This is the standard reporting path for the
Campaign Manager 360 API and is suitable for large datasets, automated scheduled scripts,
or downstream applications that consume files.

The workflow typically consists of the following steps:

1. Define or locate a `Report` resource (specifying dimensions, metrics, date ranges, and filters) which is saved with a unique report ID. See [Create and
   Update Reports](https://developers.google.com/doubleclick-advertisers/guides/create_reports).
2. Run report generation by calling the [`reports.run`](https://developers.google.com/doubleclick-advertisers/current/reports/run) method. This queues the report run and returns a placeholder `File` resource. See [Find and Run Reports](https://developers.google.com/doubleclick-advertisers/guides/run_reports).
3. Periodically check the `File` resource's status. Because this process runs asynchronously, a file's status will start as `PROCESSING` and transition to `REPORT_AVAILABLE` when complete. See [Find and Run Reports](https://developers.google.com/doubleclick-advertisers/guides/run_reports).
4. Fetch the file content (CSV or Excel) once the report generation is complete. See [Download Reports](https://developers.google.com/doubleclick-advertisers/guides/download_reports).

### Run reports synchronously

If you need to generate a report file (CSV or Excel) for a small amount of data,
you can run the report [synchronously](https://developers.google.com/doubleclick-advertisers/guides/synchronousreports) by calling the
[`reports.run`](https://developers.google.com/doubleclick-advertisers/current/reports/run) method with the `synchronous` parameter set
to `true`. The API attempts to generate the report within a brief timeout
period. If execution takes longer, the report run automatically falls back to
the asynchronous queue.

For more details, see [Synchronous Reports](https://developers.google.com/doubleclick-advertisers/guides/synchronousreports).

## Query report data

Use the [`reportData.query`](https://developers.google.com/doubleclick-advertisers/current/reportData/query) method to query
reporting data directly instead of generating a report file.

- Instead of creating and saving a `Report` resource, you specify dimensions, metrics, and other filtering or sorting criteria directly in the request.
- The response contains structured report data, eliminating the need to poll for and download a generated file.
- The request executes synchronously with a 60-second limit.

For more details, see [Query JSON Report Data](https://developers.google.com/doubleclick-advertisers/guides/query_report_data).