Google Ads API
  • Google Ads API
  • English
  • Bahasa Indonesia
  • Deutsch
  • Español
  • Français
  • Português – Brasil
  • Русский
  • 中文 – 简体
  • 日本語
  • 한국어
Sign in
Guides Videos Migration Reference Reports Libraries & Examples REST Interface Policies Support
Google Ads API
  • Google Ads API
  • Guides
  • Videos
  • Migration
  • Reference
  • Reports
  • Libraries & Examples
  • REST Interface
  • Policies
  • Support
  • Resources
    • v13
      • Overview
      • Segments
      • Resources with metrics
        • Metrics
        • Ad Group
        • Ad Group Ad
        • Ad Group Ad Asset Combination View
        • Ad Group Ad Asset View
        • Ad Group Asset
        • Ad Group Audience View
        • Ad Schedule View
        • Age Range View
        • Asset Field Type View
        • Asset Group Product Group View
        • Asset Set Asset
        • Asset Set Type View
        • Bidding Strategy
        • Campaign
        • Campaign Asset
        • Campaign Audience View
        • Campaign Bid Modifier
        • Campaign Budget
        • Campaign Group
        • Click View
        • Conversion Action
        • Customer
        • Customer Asset
        • Detail Placement View
        • Display Keyword View
        • Distance View
        • Dynamic Search Ads Search Term View
        • Expanded Landing Page View
        • Extension Feed Item
        • Feed Item
        • Feed Placeholder View
        • Gender View
        • Geographic View
        • Group Placement View
        • Hotel Group View
        • Hotel Performance View
        • Hotel Reconciliation
        • Income Range View
        • Keyword View
        • Landing Page View
        • Location View
        • Managed Placement View
        • Paid Organic Search Term View
        • Parental Status View
        • Per Store View
        • Product Group View
        • Search Term View
        • Shopping Performance View
        • Smart Campaign Search Term View
        • Topic View
        • Travel Activity Group View
        • Travel Activity Performance View
        • User Location View
        • Video
        • Webpage View
      • Resources without metrics
        • Accessible Bidding Strategy
        • Account Budget
        • Account Budget Proposal
        • Account Link
        • Ad Group Ad Label
        • Ad Group Asset Set
        • Ad Group Bid Modifier
        • Ad Group Criterion
        • Ad Group Criterion Customizer
        • Ad Group Criterion Label
        • Ad Group Criterion Simulation
        • Ad Group Customizer
        • Ad Group Extension Setting
        • Ad Group Feed
        • Ad Group Label
        • Ad Group Simulation
        • Ad Parameter
        • Asset
        • Asset Group
        • Asset Group Asset
        • Asset Group Listing Group Filter
        • Asset Group Signal
        • Asset Set
        • Audience
        • Batch Job
        • Bidding Data Exclusion
        • Bidding Seasonality Adjustment
        • Bidding Strategy Simulation
        • Billing Setup
        • Call View
        • Campaign Asset Set
        • Campaign Conversion Goal
        • Campaign Criterion
        • Campaign Criterion Simulation
        • Campaign Customizer
        • Campaign Draft
        • Campaign Extension Setting
        • Campaign Feed
        • Campaign Label
        • Campaign Shared Set
        • Campaign Simulation
        • Carrier Constant
        • Change Event
        • Change Status
        • Combined Audience
        • Conversion Custom Variable
        • Conversion Goal Campaign Config
        • Conversion Value Rule
        • Conversion Value Rule Set
        • Currency Constant
        • Custom Audience
        • Custom Conversion Goal
        • Custom Interest
        • Customer Asset Set
        • Customer Client
        • Customer Client Link
        • Customer Conversion Goal
        • Customer Customizer
        • Customer Extension Setting
        • Customer Feed
        • Customer Label
        • Customer Manager Link
        • Customer Negative Criterion
        • Customer User Access
        • Customer User Access Invitation
        • Customizer Attribute
        • Detailed Demographic
        • Domain Category
        • Experiment
        • Experiment Arm
        • Feed
        • Feed Item Set
        • Feed Item Set Link
        • Feed Item Target
        • Feed Mapping
        • Geo Target Constant
        • Keyword Plan
        • Keyword Plan Ad Group
        • Keyword Plan Ad Group Keyword
        • Keyword Plan Campaign
        • Keyword Plan Campaign Keyword
        • Keyword Theme Constant
        • Label
        • Language Constant
        • Lead Form Submission Data
        • Life Event
        • Media File
        • Mobile App Category Constant
        • Mobile Device Constant
        • Offline User Data Job
        • Operating System Version Constant
        • Product Bidding Category Constant
        • Product Link
        • Qualifying Question
        • Recommendation
        • Remarketing Action
        • Shared Criterion
        • Shared Set
        • Smart Campaign Setting
        • Third Party App Analytics Link
        • Topic Constant
        • User Interest
        • User List
      • Query Builder
        • Overview
        • Resources
          • Accessible Bidding Strategy
          • Account Budget
          • Account Budget Proposal
          • Account Link
          • Ad Group
          • Ad Group Ad
          • Ad Group Ad Asset Combination View
          • Ad Group Ad Asset View
          • Ad Group Ad Label
          • Ad Group Asset
          • Ad Group Asset Set
          • Ad Group Audience View
          • Ad Group Bid Modifier
          • Ad Group Criterion
          • Ad Group Criterion Customizer
          • Ad Group Criterion Label
          • Ad Group Criterion Simulation
          • Ad Group Customizer
          • Ad Group Extension Setting
          • Ad Group Feed
          • Ad Group Label
          • Ad Group Simulation
          • Ad Parameter
          • Ad Schedule View
          • Age Range View
          • Asset
          • Asset Field Type View
          • Asset Group
          • Asset Group Asset
          • Asset Group Listing Group Filter
          • Asset Group Product Group View
          • Asset Group Signal
          • Asset Set
          • Asset Set Asset
          • Asset Set Type View
          • Audience
          • Batch Job
          • Bidding Data Exclusion
          • Bidding Seasonality Adjustment
          • Bidding Strategy
          • Bidding Strategy Simulation
          • Billing Setup
          • Call View
          • Campaign
          • Campaign Asset
          • Campaign Asset Set
          • Campaign Audience View
          • Campaign Bid Modifier
          • Campaign Budget
          • Campaign Conversion Goal
          • Campaign Criterion
          • Campaign Criterion Simulation
          • Campaign Customizer
          • Campaign Draft
          • Campaign Extension Setting
          • Campaign Feed
          • Campaign Group
          • Campaign Label
          • Campaign Shared Set
          • Campaign Simulation
          • Carrier Constant
          • Change Event
          • Change Status
          • Click View
          • Combined Audience
          • Conversion Action
          • Conversion Custom Variable
          • Conversion Goal Campaign Config
          • Conversion Value Rule
          • Conversion Value Rule Set
          • Currency Constant
          • Custom Audience
          • Custom Conversion Goal
          • Custom Interest
          • Customer
          • Customer Asset
          • Customer Asset Set
          • Customer Client
          • Customer Client Link
          • Customer Conversion Goal
          • Customer Customizer
          • Customer Extension Setting
          • Customer Feed
          • Customer Label
          • Customer Manager Link
          • Customer Negative Criterion
          • Customer User Access
          • Customer User Access Invitation
          • Customizer Attribute
          • Detail Placement View
          • Detailed Demographic
          • Display Keyword View
          • Distance View
          • Domain Category
          • Dynamic Search Ads Search Term View
          • Expanded Landing Page View
          • Experiment
          • Experiment Arm
          • Extension Feed Item
          • Feed
          • Feed Item
          • Feed Item Set
          • Feed Item Set Link
          • Feed Item Target
          • Feed Mapping
          • Feed Placeholder View
          • Gender View
          • Geo Target Constant
          • Geographic View
          • Group Placement View
          • Hotel Group View
          • Hotel Performance View
          • Hotel Reconciliation
          • Income Range View
          • Keyword Plan
          • Keyword Plan Ad Group
          • Keyword Plan Ad Group Keyword
          • Keyword Plan Campaign
          • Keyword Plan Campaign Keyword
          • Keyword Theme Constant
          • Keyword View
          • Label
          • Landing Page View
          • Language Constant
          • Lead Form Submission Data
          • Life Event
          • Location View
          • Managed Placement View
          • Media File
          • Mobile App Category Constant
          • Mobile Device Constant
          • Offline User Data Job
          • Operating System Version Constant
          • Paid Organic Search Term View
          • Parental Status View
          • Per Store View
          • Product Bidding Category Constant
          • Product Group View
          • Product Link
          • Qualifying Question
          • Recommendation
          • Remarketing Action
          • Search Term View
          • Shared Criterion
          • Shared Set
          • Shopping Performance View
          • Smart Campaign Search Term View
          • Smart Campaign Setting
          • Third Party App Analytics Link
          • Topic Constant
          • Topic View
          • Travel Activity Group View
          • Travel Activity Performance View
          • User Interest
          • User List
          • User Location View
          • Video
          • Webpage View
      • Query Validator
    • v12
      • Overview
      • Segments
      • Resources with metrics
        • Metrics
        • Ad Group
        • Ad Group Ad
        • Ad Group Ad Asset Combination View
        • Ad Group Ad Asset View
        • Ad Group Asset
        • Ad Group Audience View
        • Ad Schedule View
        • Age Range View
        • Asset Field Type View
        • Asset Group Product Group View
        • Asset Set Asset
        • Asset Set Type View
        • Bidding Strategy
        • Campaign
        • Campaign Asset
        • Campaign Audience View
        • Campaign Bid Modifier
        • Campaign Budget
        • Campaign Group
        • Click View
        • Conversion Action
        • Customer
        • Customer Asset
        • Detail Placement View
        • Display Keyword View
        • Distance View
        • Dynamic Search Ads Search Term View
        • Expanded Landing Page View
        • Extension Feed Item
        • Feed Item
        • Feed Placeholder View
        • Gender View
        • Geographic View
        • Group Placement View
        • Hotel Group View
        • Hotel Performance View
        • Hotel Reconciliation
        • Income Range View
        • Keyword View
        • Landing Page View
        • Location View
        • Managed Placement View
        • Paid Organic Search Term View
        • Parental Status View
        • Per Store View
        • Product Group View
        • Search Term View
        • Shopping Performance View
        • Smart Campaign Search Term View
        • Topic View
        • User Location View
        • Video
        • Webpage View
      • Resources without metrics
        • Accessible Bidding Strategy
        • Account Budget
        • Account Budget Proposal
        • Account Link
        • Ad Group Ad Label
        • Ad Group Asset Set
        • Ad Group Bid Modifier
        • Ad Group Criterion
        • Ad Group Criterion Customizer
        • Ad Group Criterion Label
        • Ad Group Criterion Simulation
        • Ad Group Customizer
        • Ad Group Extension Setting
        • Ad Group Feed
        • Ad Group Label
        • Ad Group Simulation
        • Ad Parameter
        • Asset
        • Asset Group
        • Asset Group Asset
        • Asset Group Listing Group Filter
        • Asset Group Signal
        • Asset Set
        • Audience
        • Batch Job
        • Bidding Data Exclusion
        • Bidding Seasonality Adjustment
        • Bidding Strategy Simulation
        • Billing Setup
        • Call View
        • Campaign Asset Set
        • Campaign Conversion Goal
        • Campaign Criterion
        • Campaign Criterion Simulation
        • Campaign Customizer
        • Campaign Draft
        • Campaign Extension Setting
        • Campaign Feed
        • Campaign Label
        • Campaign Shared Set
        • Campaign Simulation
        • Carrier Constant
        • Change Event
        • Change Status
        • Combined Audience
        • Conversion Custom Variable
        • Conversion Goal Campaign Config
        • Conversion Value Rule
        • Conversion Value Rule Set
        • Currency Constant
        • Custom Audience
        • Custom Conversion Goal
        • Custom Interest
        • Customer Asset Set
        • Customer Client
        • Customer Client Link
        • Customer Conversion Goal
        • Customer Customizer
        • Customer Extension Setting
        • Customer Feed
        • Customer Label
        • Customer Manager Link
        • Customer Negative Criterion
        • Customer User Access
        • Customer User Access Invitation
        • Customizer Attribute
        • Detailed Demographic
        • Domain Category
        • Experiment
        • Experiment Arm
        • Feed
        • Feed Item Set
        • Feed Item Set Link
        • Feed Item Target
        • Feed Mapping
        • Geo Target Constant
        • Keyword Plan
        • Keyword Plan Ad Group
        • Keyword Plan Ad Group Keyword
        • Keyword Plan Campaign
        • Keyword Plan Campaign Keyword
        • Keyword Theme Constant
        • Label
        • Language Constant
        • Lead Form Submission Data
        • Life Event
        • Media File
        • Mobile App Category Constant
        • Mobile Device Constant
        • Offline User Data Job
        • Operating System Version Constant
        • Product Bidding Category Constant
        • Recommendation
        • Remarketing Action
        • Shared Criterion
        • Shared Set
        • Smart Campaign Setting
        • Third Party App Analytics Link
        • Topic Constant
        • User Interest
        • User List
      • Query Builder
        • Overview
        • Resources
          • Accessible Bidding Strategy
          • Account Budget
          • Account Budget Proposal
          • Account Link
          • Ad Group
          • Ad Group Ad
          • Ad Group Ad Asset Combination View
          • Ad Group Ad Asset View
          • Ad Group Ad Label
          • Ad Group Asset
          • Ad Group Asset Set
          • Ad Group Audience View
          • Ad Group Bid Modifier
          • Ad Group Criterion
          • Ad Group Criterion Customizer
          • Ad Group Criterion Label
          • Ad Group Criterion Simulation
          • Ad Group Customizer
          • Ad Group Extension Setting
          • Ad Group Feed
          • Ad Group Label
          • Ad Group Simulation
          • Ad Parameter
          • Ad Schedule View
          • Age Range View
          • Asset
          • Asset Field Type View
          • Asset Group
          • Asset Group Asset
          • Asset Group Listing Group Filter
          • Asset Group Product Group View
          • Asset Group Signal
          • Asset Set
          • Asset Set Asset
          • Asset Set Type View
          • Audience
          • Batch Job
          • Bidding Data Exclusion
          • Bidding Seasonality Adjustment
          • Bidding Strategy
          • Bidding Strategy Simulation
          • Billing Setup
          • Call View
          • Campaign
          • Campaign Asset
          • Campaign Asset Set
          • Campaign Audience View
          • Campaign Bid Modifier
          • Campaign Budget
          • Campaign Conversion Goal
          • Campaign Criterion
          • Campaign Criterion Simulation
          • Campaign Customizer
          • Campaign Draft
          • Campaign Extension Setting
          • Campaign Feed
          • Campaign Group
          • Campaign Label
          • Campaign Shared Set
          • Campaign Simulation
          • Carrier Constant
          • Change Event
          • Change Status
          • Click View
          • Combined Audience
          • Conversion Action
          • Conversion Custom Variable
          • Conversion Goal Campaign Config
          • Conversion Value Rule
          • Conversion Value Rule Set
          • Currency Constant
          • Custom Audience
          • Custom Conversion Goal
          • Custom Interest
          • Customer
          • Customer Asset
          • Customer Asset Set
          • Customer Client
          • Customer Client Link
          • Customer Conversion Goal
          • Customer Customizer
          • Customer Extension Setting
          • Customer Feed
          • Customer Label
          • Customer Manager Link
          • Customer Negative Criterion
          • Customer User Access
          • Customer User Access Invitation
          • Customizer Attribute
          • Detail Placement View
          • Detailed Demographic
          • Display Keyword View
          • Distance View
          • Domain Category
          • Dynamic Search Ads Search Term View
          • Expanded Landing Page View
          • Experiment
          • Experiment Arm
          • Extension Feed Item
          • Feed
          • Feed Item
          • Feed Item Set
          • Feed Item Set Link
          • Feed Item Target
          • Feed Mapping
          • Feed Placeholder View
          • Gender View
          • Geo Target Constant
          • Geographic View
          • Group Placement View
          • Hotel Group View
          • Hotel Performance View
          • Hotel Reconciliation
          • Income Range View
          • Keyword Plan
          • Keyword Plan Ad Group
          • Keyword Plan Ad Group Keyword
          • Keyword Plan Campaign
          • Keyword Plan Campaign Keyword
          • Keyword Theme Constant
          • Keyword View
          • Label
          • Landing Page View
          • Language Constant
          • Lead Form Submission Data
          • Life Event
          • Location View
          • Managed Placement View
          • Media File
          • Mobile App Category Constant
          • Mobile Device Constant
          • Offline User Data Job
          • Operating System Version Constant
          • Paid Organic Search Term View
          • Parental Status View
          • Per Store View
          • Product Bidding Category Constant
          • Product Group View
          • Recommendation
          • Remarketing Action
          • Search Term View
          • Shared Criterion
          • Shared Set
          • Shopping Performance View
          • Smart Campaign Search Term View
          • Smart Campaign Setting
          • Third Party App Analytics Link
          • Topic Constant
          • Topic View
          • User Interest
          • User List
          • User Location View
          • Video
          • Webpage View
      • Query Validator
  • Home
  • Products
  • Google Ads API
  • Reports

Google Ads Query Builder

Stay organized with collections Save and categorize content based on your preferences.

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

Last updated 2023-03-30 UTC.

  • Blog Blog
    Visit our blog for important announcements.
  • Forum Forum
    Interact with our community of developer experts.
  • Client Libraries Client Libraries
    Use our officially supported client libraries.
  • YouTube YouTube
    Access our video contents.
Google Developers
  • Android
  • Chrome
  • Firebase
  • Google Cloud Platform
  • All products
  • Terms
  • Privacy
  • Sign up for the Google for Developers newsletter Subscribe
  • English
  • Bahasa Indonesia
  • Deutsch
  • Español
  • Français
  • Português – Brasil
  • Русский
  • 中文 – 简体
  • 日本語
  • 한국어