Reports

  • This documentation details resources queryable in the Google Ads API usingGoogleAdsService.SearchStream orGoogleAdsService.Search.

  • Each resource page outlines usable artifacts, attributed resources, and lists queryable fields, segments, and metrics with metadata like category, data type, filterable, and selectable properties.

  • A comprehensive list of available resources and their descriptions is provided, covering account management, advertising assets, audiences, bidding, campaigns, reporting, and various other data views and objects.

  • Resources likecustomer,customizer_attribute, and various data views provide insights into account management, customizable attributes, and performance data across different levels.

  • The documentation also includes resources for keyword planning, experiments, and other functionalities such as geo targeting, labels, and media files.

Overview

These pages serve as reference for the resources that can be queried in the Google Ads API usingGoogleAdsService.SearchStream orGoogleAdsService.Search. To familiarizeyourself instead with various reporting concepts, refer to thereporting guide.

Each resource name is linked to to its own page. On each page, the following lists are shown:

  • Artifacts (resources, segments, or metrics) that can be used in the same SELECT clause with the resource
  • Attributed resources whose fields will not segment metrics, when included in the same SELECT and WHERE clauses of these resource fields

Presented after those lists are the tables consisting of names of resource fields, segments, and metrics that can be included in a search query, when this resourceis specified in the FROM clause.Each name is linked to the table that contains its metadata:

  • category
  • data type
  • type URL
  • filterable
  • selectable
  • sortable
  • repeated
Filterable
This row indicates whether the field can be used in the conditions oftheWHERE clause of theGAQL query.
Selectable
This row indicates whether the field can be specified in theSELECT clause of theGAQL query.
Sortable
This row indicates whether the field can be sorted and used in theORDER BY clause of theGAQL query.
Repeated
This row indicates whether the field isrepeated, whichshould be handled as a list.

List of all resources

Resource types
accessible_bidding_strategyRepresents a view of BiddingStrategies owned by and shared with the customer. In contrast to BiddingStrategy, this resource includes strategies owned by managers of the customer and shared with this customer - in addition to strategies owned by this customer. This resource does not provide metrics and only exposes a limited subset of the BiddingStrategy attributes.
account_budgetAn account-level budget. It contains information about the budget itself, as well as the most recently approved changes to the budget and proposed changes that are pending approval. The proposed changes that are pending approval, if any, are found in 'pending_proposal'. Effective details about the budget are found in fields prefixed 'approved_', 'adjusted_' and those without a prefix. Since some effective details may differ from what the user had originally requested (for example, spending limit), these differences are juxtaposed through 'proposed_', 'approved_', and possibly 'adjusted_' fields. This resource is mutated using AccountBudgetProposal and cannot be mutated directly. A budget may have at most one pending proposal at any given time. It is read through pending_proposal. Once approved, a budget may be subject to adjustments, such as credit adjustments. Adjustments create differences between the 'approved' and 'adjusted' fields, which would otherwise be identical.
account_budget_proposalAn account-level budget proposal. All fields prefixed with 'proposed' may not necessarily be applied directly. For example, proposed spending limits may be adjusted before their application. This is true if the 'proposed' field has an 'approved' counterpart, for example, spending limits. Note that the proposal type (proposal_type) changes which fields are required and which must remain empty.
account_linkRepresents the data sharing connection between a Google Ads account and another account
adAn ad.
ad_groupAn ad group.
ad_group_adAn ad group ad.
ad_group_ad_asset_combination_viewA view on the usage of ad group ad asset combination. Now we only support AdGroupAdAssetCombinationView for Responsive Search Ads, with more ad types planned for the future.
ad_group_ad_asset_viewA link between an AdGroupAd and an Asset. AdGroupAdAssetView supports AppAds, Demand Gen campaigns, and Responsive Search Ads.
ad_group_ad_labelA relationship between an ad group ad and a label.
ad_group_assetA link between an ad group and an asset.
ad_group_asset_setAdGroupAssetSet is the linkage between an ad group and an asset set. Creating an AdGroupAssetSet links an asset set with an ad group.
ad_group_audience_viewAn ad group audience view. Includes performance data from interests and remarketing lists for Display Network and YouTube Network ads, and remarketing lists for search ads (RLSA), aggregated at the audience level.
ad_group_bid_modifierRepresents an ad group bid modifier.
ad_group_criterionAn ad group criterion. The ad_group_criterion report only returns criteria that were explicitly added to the ad group.
ad_group_criterion_customizerA customizer value for the associated CustomizerAttribute at the AdGroupCriterion level.
ad_group_criterion_labelA relationship between an ad group criterion and a label.
ad_group_criterion_simulationAn ad group criterion simulation. Supported combinations of advertising channel type, criterion type, simulation type, and simulation modification method are detailed below respectively. Hotel AdGroupCriterion simulation operations starting in V5. 1. DISPLAY - KEYWORD - CPC_BID - UNIFORM 2. SEARCH - KEYWORD - CPC_BID - UNIFORM 3. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM 4. HOTEL - LISTING_GROUP - CPC_BID - UNIFORM 5. HOTEL - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
ad_group_customizerA customizer value for the associated CustomizerAttribute at the AdGroup level.
ad_group_labelA relationship between an ad group and a label.
ad_group_simulationAn ad group simulation. Supported combinations of advertising channel type, simulation type and simulation modification method is detailed below respectively. 1. SEARCH - CPC_BID - DEFAULT 2. SEARCH - CPC_BID - UNIFORM 3. SEARCH - TARGET_CPA - UNIFORM 4. SEARCH - TARGET_ROAS - UNIFORM 5. DISPLAY - CPC_BID - DEFAULT 6. DISPLAY - CPC_BID - UNIFORM 7. DISPLAY - TARGET_CPA - UNIFORM
ad_parameterAn ad parameter that is used to update numeric values (such as prices or inventory levels) in any text line of an ad (including URLs). There can be a maximum of two AdParameters per ad group criterion. (One with parameter_index = 1 and one with parameter_index = 2.) In the ad the parameters are referenced by a placeholder of the form "{param#:value}". For example, "{param1:$17}"
ad_schedule_viewAn ad schedule view summarizes the performance of campaigns by AdSchedule criteria.
age_range_viewAn age range view.
ai_max_search_term_ad_combination_viewAiMaxSearchTermAdCombinationView Resource.
android_privacy_shared_key_google_ad_groupAn Android privacy shared key view for Google ad group key.
android_privacy_shared_key_google_campaignAn Android privacy shared key view for Google campaign key.
android_privacy_shared_key_google_network_typeAn Android privacy shared key view for Google network type key.
assetAsset is a part of an ad which can be shared across multiple ads. It can be an image (ImageAsset), a video (YoutubeVideoAsset), etc. Assets are immutable and cannot be removed. To stop an asset from serving, remove the asset from the entity that is using it.
asset_field_type_viewAn asset field type view. This view reports non-overcounted metrics for each asset field type when the asset is used as extension.
asset_groupAn asset group. AssetGroupAsset is used to link an asset to the asset group. AssetGroupSignal is used to associate a signal to an asset group.
asset_group_assetAssetGroupAsset is the link between an asset and an asset group. Adding an AssetGroupAsset links an asset with an asset group.
asset_group_listing_group_filterAssetGroupListingGroupFilter represents a listing group filter tree node in an asset group.
asset_group_product_group_viewAn asset group product group view.
asset_group_signalAssetGroupSignal represents a signal in an asset group. The existence of a signal tells the performance max campaign who's most likely to convert. Performance Max uses the signal to look for new people with similar or stronger intent to find conversions across Search, Display, Video, and more.
asset_group_top_combination_viewA view on the usage of asset group asset top combinations.
asset_setAn asset set representing a collection of assets. Use AssetSetAsset to link an asset to the asset set.
asset_set_assetAssetSetAsset is the link between an asset and an asset set. Adding an AssetSetAsset links an asset with an asset set.
asset_set_type_viewAn asset set type view. This view reports non-overcounted metrics for each asset set type. Child asset set types are not included in this report. Their stats are aggregated under the parent asset set type.
audienceAudience is an effective targeting option that lets you intersect different segment attributes, such as detailed demographics and affinities, to create audiences that represent sections of your target segments.
batch_jobA list of mutates being processed asynchronously. The mutates are uploaded by the user. The mutates themselves aren't readable and the results of the job can only be read using BatchJobService.ListBatchJobResults.
bidding_data_exclusionRepresents a bidding data exclusion. Bidding data exclusions can be set in client accounts only, and cannot be used in manager accounts. See "About data exclusions" athttps://support.google.com/google-ads/answer/10370710.
bidding_seasonality_adjustmentRepresents a bidding seasonality adjustment. Cannot be used in manager accounts. See "About seasonality adjustments" athttps://support.google.com/google-ads/answer/10369906.
bidding_strategyA bidding strategy.
bidding_strategy_simulationA bidding strategy simulation. Supported combinations of simulation type and simulation modification method are detailed below respectively. 1. TARGET_CPA - UNIFORM 2. TARGET_ROAS - UNIFORM
billing_setupA billing setup, which associates a payments account and an advertiser. A billing setup is specific to one advertiser.
call_viewA call view that includes data for call tracking of call-only ads or call extensions.
campaignA campaign.
campaign_aggregate_asset_viewA campaign-level aggregate asset view that shows where the asset is linked, performamce of the asset and stats.
campaign_assetA link between a Campaign and an Asset.
campaign_asset_setCampaignAssetSet is the linkage between a campaign and an asset set. Adding a CampaignAssetSet links an asset set with a campaign.
campaign_audience_viewA campaign audience view. Includes performance data from interests and remarketing lists for Display Network and YouTube Network ads, and remarketing lists for search ads (RLSA), aggregated by campaign and audience criterion. This view only includes audiences attached at the campaign level.
campaign_bid_modifierRepresents a bid-modifiable only criterion at the campaign level.
campaign_budgetA campaign budget.
campaign_conversion_goalThe biddability setting for the specified campaign only for all conversion actions with a matching category and origin.
campaign_criterionA campaign criterion.
campaign_customizerA customizer value for the associated CustomizerAttribute at the Campaign level.
campaign_draftA campaign draft.
campaign_goal_configA link between a campaign and a goal enabling campaign-specific optimization.
campaign_groupA campaign group.
campaign_labelRepresents a relationship between a campaign and a label.
campaign_lifecycle_goalCampaign level customer lifecycle goal settings.
campaign_search_term_insightThis report provides a high-level view of search demand at the campaign level by grouping similar search terms into categories and showing their search volume. Historical data is available starting March 2023.
campaign_search_term_viewThis report provides granular performance data, including cost metrics, for each individual search term that triggered your ads. If keyword-related segments are used, Performance Max data will be excluded from the results.
campaign_shared_setCampaignSharedSets are used for managing the shared sets associated with a campaign.
campaign_simulationA campaign simulation. Supported combinations of advertising channel type, simulation type and simulation modification method is detailed below respectively. * SEARCH - CPC_BID - UNIFORM * SEARCH - CPC_BID - SCALING * SEARCH - TARGET_CPA - UNIFORM * SEARCH - TARGET_CPA - SCALING * SEARCH - TARGET_ROAS - UNIFORM * SEARCH - TARGET_IMPRESSION_SHARE - UNIFORM * SEARCH - BUDGET - UNIFORM * SHOPPING - BUDGET - UNIFORM * SHOPPING - TARGET_ROAS - UNIFORM * MULTI_CHANNEL - TARGET_CPA - UNIFORM * MULTI_CHANNEL - TARGET_ROAS - UNIFORM * DEMAND_GEN - TARGET_CPA - DEFAULT * DISPLAY - TARGET_CPA - UNIFORM * PERFORMANCE_MAX - TARGET_CPA - UNIFORM * PERFORMANCE_MAX - TARGET_ROAS - UNIFORM * PERFORMANCE_MAX - BUDGET - UNIFORM
carrier_constantA carrier criterion that can be used in campaign targeting.
change_eventDescribes the granular change of returned resources of certain resource types. Changes made through the UI or API in the past 30 days are included. Previous and new values of the changed fields are shown. ChangeEvent could have up to 3 minutes delay to reflect a new change.
change_statusDescribes the status of returned resource. ChangeStatus could have up to 3 minutes delay to reflect a new change.
channel_aggregate_asset_viewA channel-level aggregate asset view that shows where the asset is linked, performamce of the asset and stats.
click_viewA click view with metrics aggregated at each click level, including both valid and invalid clicks. For non-Search campaigns, metrics.clicks represents the number of valid and invalid interactions. Queries including ClickView must have a filter limiting the results to one day and can be requested for dates back to 90 days before the time of the request. GCLIDs are not available in this report for App Campaigns for Installs (ACi) and App Campaigns for Pre-registration (ACpre).
combined_audienceDescribe a resource for combined audiences which includes different audiences.
content_criterion_viewA content criterion view.
conversion_actionA conversion action.
conversion_custom_variableA conversion custom variable See "About custom variables for conversions" athttps://support.google.com/google-ads/answer/9964350
conversion_goal_campaign_configConversion goal settings for a Campaign.
conversion_value_ruleA conversion value rule
conversion_value_rule_setA conversion value rule set is a collection of conversion value rules that lets you adjust conversion values based on the dimensions specified in thedimensions field.
currency_constantA currency constant.
custom_audienceA custom audience. This is a list of users by interest. The unique key of a custom audience consists of the following fields: name. Violating the unique key constraint produces error: CustomAudienceError.NAME_ALREADY_USED
custom_conversion_goalCustom conversion goal that can make arbitrary conversion actions biddable.
custom_interestA custom interest. This is a list of users by interest.
customerA customer.
customer_assetA link between a customer and an asset.
customer_asset_setCustomerAssetSet is the linkage between a customer and an asset set. Adding a CustomerAssetSet links an asset set with a customer.
customer_clientA link between the given customer and a client customer. CustomerClients only exist for manager customers. All direct and indirect client customers are included, as well as the manager itself.
customer_client_linkRepresents customer client link relationship.
customer_conversion_goalBiddability control for conversion actions with a matching category and origin.
customer_customizerA customizer value for the associated CustomizerAttribute at the Customer level.
customer_labelRepresents a relationship between a customer and a label. This customer may not have access to all the labels attached to it. Additional CustomerLabels may be returned by increasing permissions with login-customer-id.
customer_lifecycle_goalAccount level customer lifecycle goal settings.
customer_manager_linkRepresents customer-manager link relationship.
customer_negative_criterionA negative criterion for exclusions at the customer level.
customer_search_term_insightThis report provides a high-level view of search demand at the customer level by grouping similar search terms into categories and showing their search volume. Historical data is available starting March 2023.
customer_user_accessRepresents the permission of a single user onto a single customer.
customer_user_access_invitationRepresent an invitation to a new user on this customer account.
customizer_attributeA customizer attribute. Use CustomerCustomizer, CampaignCustomizer, AdGroupCustomizer, or AdGroupCriterionCustomizer to associate a customizer attribute and set its value at the customer, campaign, ad group, or ad group criterion level, respectively.
data_linkRepresents the data sharing connection between a Google Ads customer and another product's data.
detail_content_suitability_placement_viewA detail content suitability placement view.
detail_placement_viewA view with metrics aggregated by ad group and URL or YouTube video. This view primarily surfaces placement data from the Google Display Network. While you can select segments likesegments.ad_network_type, this view generally does not include placement data from other networks, such as the Search Partners network. To understand performance on Search Partners, consider other reports and segmentations.
detailed_demographicA detailed demographic: a particular interest-based vertical to be targeted to reach users based on long-term life facts.
display_keyword_viewA display keyword view. Provides performance data for keywords used in Display Network campaigns. This view lets you analyze how your display keywords are performing across various segments. This view is primarily used to track the effectiveness of keyword targeting within your Display campaigns. To understand which network the metrics apply to, you can select thesegments.ad_network_type field in your query. This field will segment the data by networks such as the Google Display Network, YouTube, Gmail, and so on. You can select fields from this resource along with metrics like impressions, clicks, and conversions to gauge performance. Attributed resources likead_group andcampaign can also be selected without segmenting metrics.
distance_viewA distance view with metrics aggregated by the user's distance from an advertiser's location extensions. Each DistanceBucket includes all impressions that fall within its distance and a single impression will contribute to the metrics for all DistanceBuckets that include the user's distance.
domain_categoryA category generated automatically by crawling a domain. If a campaign uses the DynamicSearchAdsSetting, then domain categories will be generated for the domain. The categories can be targeted using WebpageConditionInfo. See:https://support.google.com/google-ads/answer/2471185
dynamic_search_ads_search_term_viewA dynamic search ads search term view.
expanded_landing_page_viewA landing page view with metrics aggregated at the expanded final URL level.
experimentA Google ads experiment for users to experiment changes on multiple campaigns, compare the performance, and apply the effective changes.
experiment_armA Google ads experiment for users to experiment changes on multiple campaigns, compare the performance, and apply the effective changes.
final_url_expansion_asset_viewFinalUrlExpansionAssetView Resource.
gender_viewA gender view. The gender_view resource reflects the effective serving state, rather than what criteria were added. An ad group without gender criteria by default shows to all genders, so all genders appear in gender_view with stats.
geo_target_constantA geo target constant.
geographic_viewA geographic view. Geographic View includes all metrics aggregated at the country level, one row per country. It reports metrics at either actual physical location of the user or an area of interest. If other segment fields are used, you may get more than one row per country.
goalRepresentation of goals.
group_content_suitability_placement_viewA group content suitability placement view.
group_placement_viewA group placement view.
hotel_group_viewA hotel group view.
hotel_performance_viewA hotel performance view.
hotel_reconciliationA hotel reconciliation. It contains conversion information from Hotel bookings to reconcile with advertiser records. These rows may be updated or canceled before billing through Bulk Uploads.
income_range_viewAn income range view.
keyword_planA Keyword Planner plan. Max number of saved keyword plans: 10000. It's possible to remove plans if limit is reached.
keyword_plan_ad_groupA Keyword Planner ad group. Max number of keyword plan ad groups per plan: 200.
keyword_plan_ad_group_keywordA Keyword Plan ad group keyword. Max number of keyword plan keywords per plan: 10000.
keyword_plan_campaignA Keyword Plan campaign. Max number of keyword plan campaigns per plan allowed: 1.
keyword_plan_campaign_keywordA Keyword Plan Campaign keyword. Only negative keywords are supported for Campaign Keyword.
keyword_theme_constantA Smart Campaign keyword theme constant.
keyword_viewA keyword view.
labelA label.
landing_page_viewA landing page view with metrics aggregated at the unexpanded final URL level.
language_constantA language.
lead_form_submission_dataData from lead form submissions.
life_eventA life event: a particular interest-based vertical to be targeted to reach users when they are in the midst of important life milestones.
local_services_employeeA local services employee resource.
local_services_leadData from Local Services Lead. Contains details of Lead which is generated when user calls, messages or books service from advertiser. More info:https://ads.google.com/local-services-ads
local_services_lead_conversationData from Local Services Lead Conversation. Contains details of Lead Conversation which is generated when user calls, messages or books service from advertiser. These are appended to a Lead. More info:https://ads.google.com/local-services-ads
local_services_verification_artifactA local services verification resource.
location_interest_viewA location interest view summarizes the performance of adgroup location interest criteria.
location_viewA location view summarizes the performance of campaigns by a Location criterion. If no Location criterion is set, no results are returned; instead, use geographic_view or user_location_view for visitor location data.
managed_placement_viewA managed placement view.
media_fileA media file.
mobile_app_category_constantA mobile application category constant.
mobile_device_constantA mobile device constant.
offline_conversion_upload_client_summaryOffline conversion upload summary at customer level.
offline_conversion_upload_conversion_action_summaryOffline conversion upload summary at conversion action level.
offline_user_data_jobA job containing offline user data of store visitors, or user list members that will be processed asynchronously. The uploaded data isn't readable and the processing results of the job can only be read using GoogleAdsService.Search/SearchStream.
operating_system_version_constantA mobile operating system version or a range of versions, depending onoperator_type. List of available mobile platforms athttps://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms
paid_organic_search_term_viewA paid organic search term view providing a view of search stats across ads and organic listings aggregated by search term at the ad group level.
parental_status_viewA parental status view.
per_store_viewA per store view. This view provides per store impression reach and local action conversion stats for advertisers.
performance_max_placement_viewA view with impression metrics for Performance Max campaign placements.
product_category_constantA Product Category.
product_group_viewA product group view.
product_linkRepresents the data sharing connection between a Google Ads customer and another product.
product_link_invitationRepresents an invitation for data sharing connection between a Google Ads account and another account.
qualifying_questionQualifying Questions for Lead Form.
recommendationA recommendation.
recommendation_subscriptionRecommendation Subscription resource
remarketing_actionA remarketing action. A snippet of JavaScript code that will collect the product id and the type of page people visited (product page, shopping cart page, purchase page, general site visit) on an advertiser's website.
search_term_viewA search term view with metrics aggregated by search term at the ad group level. This view does not include Performance Max data. If you are looking for Performance Max search term data, use the CampaignSearchTermView instead.
shared_criterionA criterion belonging to a shared set.
shared_setSharedSets are used for sharing criterion exclusions across multiple campaigns.
shopping_performance_viewShopping performance view. Provides Shopping campaign and Performance Max campaign statistics aggregated at several product dimension levels. Product dimension values from Merchant Center such as brand, category, custom attributes, product condition, and product type will reflect the state of each dimension as of the date and time when the corresponding event was recorded. The number of impressions and clicks thatshopping_performance_view returns stats for may be different from campaign reports.shopping_performance_view shows impressions and clicks on products appearing in ads, while campaign reports show impressions and clicks on the ads themselves. Depending on the format, an ad can show from zero to several products, so the numbers may not match. In Google Ads UI, you can query impressions and clicks of products appearing in ads by selecting a column from "Product attributes" in the report editor. For example, selecting the "Brand" column is equivalent to selectingsegments.product_brand.
shopping_productA shopping product from Google Merchant Center that can be advertised by campaigns. The resource returns currently existing products from Google Merchant Center accounts linked with the customer. A campaign includes a product by specifying its merchant id (or, if available, the Multi Client Account id of the merchant) in theShoppingSetting, and can limit the inclusion to products having a specified feed label. Standard Shopping campaigns can also limit the inclusion through acampaign_criterion.listing_scope. Queries to this resource specify a scope: Account: - Filters on campaigns or ad groups are not specified. - All products from the linked Google Merchant Center accounts are returned. - Metrics and some fields (see the per-field documentation) are aggregated across all Shopping and Performance Max campaigns that include a product. Campaign: - An equality filter oncampaign is specified. Supported campaign types are Shopping, Performance Max, Demand Gen, Video. - Only products that are included by the specified campaign are returned. - Metrics and some fields (see the per-field documentation) are restricted to the specified campaign. - Only the following metrics are supported for Demand Gen and Video campaigns: impressions, clicks, ctr. Ad group: - An equality filter onad group andcampaign is specified. Supported campaign types are Shopping, Demand Gen, Video. - Only products that are included by the specified campaign are returned. - Metrics and some fields (see the per-field documentation) are restricted to the specified ad group. - Only the following metrics are supported for Demand Gen and Video campaigns: impressions, clicks, ctr. Note that segmentation by date segments is not permitted and will return UNSUPPORTED_DATE_SEGMENTATION error. On the other hand, filtering on date segments is allowed.
smart_campaign_search_term_viewA Smart campaign search term view.
smart_campaign_settingSettings for configuring Smart campaigns.
targeting_expansion_viewA targeting expansion view with metrics. Returns metrics for automated expansion over manual targeting.
third_party_app_analytics_linkA data sharing connection, allowing the import of third party app analytics into a Google Ads Customer.
topic_constantUse topics to target or exclude placements in the Google Display Network based on the category into which the placement falls (for example, "Pets & Animals/Pets/Dogs").
topic_viewA topic view.
travel_activity_group_viewA travel activity group view.
travel_activity_performance_viewA travel activity performance view.
user_interestA user interest: a particular interest-based vertical to be targeted.
user_listA user list. This is a list of users a customer may target.
user_list_customer_typeA user list customer type
user_location_viewA user location view. User Location View includes all metrics aggregated at the country level, one row per country. It reports metrics at the actual physical location of the user by targeted or not targeted location. If other segment fields are used, you may get more than one row per country.
videoA video.
webpage_viewA webpage view.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-01-28 UTC.