Reporting overview

Page Summary

• The Google Ads API provides flexible reporting options to obtain performance data for all resources, from entire campaigns to specific keywords.

• This guide explains how to create and submit a query to the Google Ads API to retrieve data.

• Detailed information about reporting and queryable resources can be found in the Reports reference documentation.

Reporting performance data is an integral part of Google Ads API applications. With the flexible reporting options in the API, you can obtain performance data for all queryable resources, ranging from an entire campaign to the specific keywords that triggered your ad.

To retrieve reporting data in the Google Ads API, you construct a query using the Google Ads Query Language (GAQL) that specifies the target resource in the FROM clause and the selected attributes, segments, and metrics in the SELECT clause. You then submit the query to either GoogleAdsService.SearchStream (to stream the entire dataset over a single connection) or GoogleAdsService.Search (to page through results). For a complete list of queryable resources, fields, and metrics, see the Reports reference documentation.

Next steps

Jump to the section of this guide that best fits your use case:

• Try a quick example
• Retrieve criteria performance metrics
• Segment your report data
• Handle zero-metric rows
• Use labels to organize and filter reports
• Stream reporting data with SearchStream
• Page through large result sets
• Map UI reports to API resources
• Review Google Ads Query Language syntax
• Manage reporting data efficiently