보고
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
ondemand_video
동영상: 2019년 워크숍의 보고 관련 강연 확인하기
실적 데이터 보고는 Google Ads API 애플리케이션의 필수적인 부분입니다. 이 API의 유연한 보고 옵션을 사용하면 모든 리소스의 실적 데이터를 얻을 수 있습니다. 여기에는 전체 캠페인부터 광고를 트리거한 키워드 집합까지 모든 항목이 포함됩니다.
이 가이드에서는 데이터를 가져오기 위해 Google Ads API에 쿼리를 만들어 제출하는 데 필요한 단계를 설명합니다. 보고에 관한 자세한 내용은 보고서 참조 문서를 참고하세요. 이 문서에서는 GoogleAdsService.SearchStream
또는 GoogleAdsService.Search
를 사용하여 Google Ads API에서 쿼리할 수 있는 리소스를 설명합니다.
사용 사례에 가장 적합한 가이드 섹션으로 이동하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-27(UTC)
[null,null,["최종 업데이트: 2025-08-27(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,["# Reporting\n\nondemand_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/v21/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/v21/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)"]]