Reporting of performance data is an integral part of Google Ads API applications. With
the flexible reporting options for this API, you can obtain performance data for
all resources. This includes everything from
an entire campaign to a set of keywords that triggered your ad.
This guide describes the steps necessary to create and submit a query to the
Google Ads API to get back data. For more detailed information about reporting, the
Reports reference documentation describes the
resources that can be queried in the Google Ads API using
GoogleAdsService.SearchStream or GoogleAdsService.Search.
Jump to the section of this guide that best fits your use case:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eThe Google Ads API offers flexible reporting options to retrieve performance data for all resources, from campaigns to keywords.\u003c/p\u003e\n"],["\u003cp\u003eThis guide provides steps to create and submit queries for data retrieval, covering various aspects like segmentation, zero metrics handling, and streaming.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can leverage the Google Ads Query Language to define their queries and manage data efficiently using the API.\u003c/p\u003e\n"],["\u003cp\u003eResources are available to learn by example, understand criteria performance metrics, use labels for reporting, and map UI reports to API usage.\u003c/p\u003e\n"]]],[],null,["ondemand_video\n[Video: Check out the reporting talk from the 2019 workshop](https://www.youtube.com/watch?v=2GWx6jI7Ib4&list=None&start=795)\n\nReporting of performance data is an integral part of Google Ads API applications. With\nthe flexible reporting options for this API, you can obtain performance data for\nall [resources](/google-ads/api/reference/rpc/v20/overview#resources). This includes everything from\nan entire campaign to a set of keywords that triggered your ad.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThis guide describes the steps necessary to create and submit a query to the\nGoogle Ads API to get back data. For more detailed information about reporting, the\n[Reports reference documentation](/google-ads/api/fields/v20/overview) describes the\nresources that can be queried in the Google Ads API using\n`GoogleAdsService.SearchStream` or `GoogleAdsService.Search`.\n\nJump to the section of this guide that best fits your use case:\n\n- [Try a quick example](/google-ads/api/docs/reporting/example)\n- [Retrieve criteria performance metrics](/google-ads/api/docs/reporting/criteria-metrics)\n- [Learn about segmentation](/google-ads/api/docs/reporting/segmentation)\n- [Find out how to handle zero metrics](/google-ads/api/docs/reporting/zero-metrics)\n- [Learn about using labels to report on your data](/google-ads/api/docs/reporting/labels)\n- [Learn about streaming your reporting data](/google-ads/api/docs/reporting/streaming)\n- [Learn about paging your data](/google-ads/api/docs/reporting/paging)\n- [Learn about mapping UI reports to API usage](/google-ads/api/docs/reporting/uireports)\n- [Learn the syntax of the Google Ads Query Language](/google-ads/api/docs/query/overview)\n- [Learn about managing data efficiently](/google-ads/api/docs/productionize/manage-data-efficiently)"]]
