Skip to main content
Google Ads API
  • Google Ads API
/
  • English
  • Deutsch
  • Español
  • Español – América Latina
  • Français
  • Indonesia
  • Italiano
  • Polski
  • Português – Brasil
  • Tiếng Việt
  • Türkçe
  • Русский
  • עברית
  • العربيّة
  • فارسی
  • हिंदी
  • বাংলা
  • ภาษาไทย
  • 中文 – 简体
  • 中文 – 繁體
  • 日本語
  • 한국어
Sign in
Guides Reference Libraries and samples Policies Support
Google Ads API
  • Google Ads API
  • Guides
  • Reference
  • Libraries and samples
  • Policies
  • Support
  • Google Ads API overview
  • Release notes
  • Video guides
    • Overview
    • Authentication & authorization
      • Introduction
      • Web flow with the OAuth playground
      • Best practices
    • Performance Max
      • Introduction
      • Assets
      • Campaign and budget
      • Retail
      • Asset groups
      • Listing group filters
      • Asset group assets
      • Campaign conversion goals
    • Enhanced conversions for web
      • Introduction
      • Usage flow
      • Code example
    • Enhanced Conversions for Leads
      • Introduction
      • Usage Flow
    • GAQL
      • Introduction
      • Query structure & grammar
      • segmentation
      • GoogleAdsRow
      • Field Metadata
      • Fields and Clauses
      • Field compatibility
    • REST API
      • Introduction
      • Authorization with rest
      • SearchStream & search
    • Best practices
      • Retrieving information efficiently
      • Mutating information efficiently
      • Advanced information retrieval
    • Account change history
      • The Basics
      • Change Status
    • Optimization Score & Recommendations
      • Overview
      • Optimization score
      • Recommendations
        • Overview
        • Take actions
        • Apply parameters
        • Take actions in bulk
      • Error handling & testing
      • Best practices
    • Smart Bidding
      • Overview & getting started
      • MaximizeConversions & MaximizeConversionValue
    • Logging & Monitoring
      • Introduction
      • Logging & Monitoring in the Cloud
      • Sending client logs to Google Cloud
    • Integration Testing
      • Introduction
      • Testing in practice
      • Testing Best Practices
    • Authentication & Authorization
    • Introduction
    • Web Flow with the OAuth Playground
    • Best Practices
    • GAQL
    • Introduction
    • Query Structure & Grammar
    • segmentation
    • GoogleAdsRow
    • Field metadata
    • Fields and clauses
    • Field Compatibility
    • SELECT Requirement
    • Date Range Validation
    • Filtering Conditions
    • Validating Queries
    • REST API
    • Introduction
    • Authorization with REST
    • SearchStream & Search
    • Best Practices
    • Retrieving Information Efficiently
    • Mutating Information Efficiently
    • Advanced Information Retrieval
    • Account change history
    • The Basics
    • Change Status
    • Optimization score & recommendations
    • Overview
    • Deep Dive: Optimization Score
    • Deep Dive: Recommendations
    • Recommendations: Take Actions
    • Recommendations: Apply Parameters
    • Recommendations: Take Actions In Bulk
    • Error Handling & Testing
    • Best Practices
    • Smart Bidding
    • Overview & Getting Started
    • MaximizeConversions & MaximizeConversionValue
    • Logging & Monitoring
    • Introduction
    • Logging & Monitoring in the Cloud
    • Sending Client Logs to Google Cloud
  • Get started
    • Introduction
    • Quickstart
    • Handle errors
    • Common errors
    • Next steps
  • Authentication and authorization
    • Overview
    • Access model overview
    • Service account workflow
    • User authentication workflow
      • Overview
      • Single-user authentication workflow
      • Multi-user authentication workflow
      • Handling two-step verification
    • OAuth 2.0 internals
    • Set up a Google API Console project for authorization
    • Credential management
  • Basic concepts
    • Overview
    • API structure
    • Versioning
    • Changing objects
    • Retrieving objects
    • Resource metadata
    • Call structure
    • Mutates
      • Overview
      • Resource mutates
      • Bulk mutates
      • Best practices
    • Cloud-managed access levels
  • Google Ads management
  • Manage accounts
    • Overview
    • Create an account
    • Link to manager accounts
    • List accessible accounts
    • Get account hierarchy
    • Manage user access
    • Manage user access invitations
    • Link product accounts
    • Link YouTube
    • Change status
    • Change event
    • Advertiser identity verification
  • Manage assets
    • Overview
    • Creation and usage
    • Location assets
    • Automated assets
    • Asset automation settings
    • Business message assets
    • Reporting
  • Create assets with generative AI (closed beta)
    • Asset generation (closed beta)
    • Asset generation errors (closed beta)
    • Asset generation code examples (closed beta)
  • Manage billing
    • Billing overview
    • Billing setup
    • Account budget
    • Invoice
  • Create and manage campaigns
    • Explore campaign types
    • Overview
    • Create campaigns
    • Create ad groups
    • Ad management
      • Overview
      • Ad types
      • Upgraded URLs
        • Overview
        • Fields
        • Supported entities
        • Valuetrack parameters for Upgraded URLs
        • Reports
        • Serving URL expansion rules
      • Dynamic Search Ads
        • Overview
        • Create DSAs
        • DSA page feeds
        • Reporting
      • Hotel Ads
        • Overview
        • Create campaign
        • Create ad group
        • Create ad
        • Create listing groups
        • Bidding
          • Overview
          • Assign strategy
          • Set bids
          • Adjust bids
        • Reporting
        • Travel Feeds for Search Ads
      • Things to do ads
        • Overview
        • Create campaign
        • Create ad group
        • Create ad
        • Create listing groups
        • Reporting
      • Responsive display ads
        • Overview
        • Create ads
        • Retrieve ads
      • Responsive search ads
        • Overview
        • Create ads
        • Mutate ads
        • Ad customization
        • Retrieve ads
      • Shopping Ads
        • Overview
        • Link Merchant Center
        • Create campaign
        • Create ad group
        • Create ad
        • Create listing groups
        • Reporting
      • Uploaded display ads
        • Overview
        • Create uploaded display ads
        • Uploaded HTML5 ads
    • Budgets
      • Overview
      • Create budget
      • Share budget
      • Assign budget
      • Remove budget
      • Track performance
      • Restrictions & errors
    • Bidding
      • Overview
      • Strategy types
      • Strategy status
      • Portfolio and standard bidding strategies
      • Cross-account bidding strategies
      • Ad group level target overrides
      • Set bids manually
      • Manage bid modifiers
      • Create seasonality adjustments
      • Create data exclusions
    • Campaign Drafts
    • Targeting
      • Overview
      • Criteria
      • Shared sets
      • Bid modifiers
      • Location targeting
      • Targeting settings
    • Performance Max campaigns
      • Overview
      • Get started
      • Business goals
      • Online sales or lead generation
      • Online sales with a product feed
      • Travel goals
      • Concepts
      • Campaign setup
        • Create a budget
        • Create a campaign
        • Conversion goals
        • Create campaign criteria
        • ValueTrack parameters
      • Asset group setup
        • Assets
        • Asset requirements
        • Asset groups
        • Asset group signals
        • Listing groups
      • Reporting
        • Overview
        • Campaign Reporting
        • Asset Group Reporting
        • Asset Reporting
        • Retail Campaign Reporting
        • Campaign Criterion Reporting
      • Upgrade to Performance Max
        • Overview
        • Check upgrade eligibility
        • Create a campaign based on an existing campaign
        • Enhance a campaign
        • Compare performance with an existing campaign
        • Complete the upgrade
      • Best practices
      • Structure requests
      • Batch processing
      • Optimizations
      • Troubleshooting
      • Common errors when working with Performance Max
      • Resources and examples
      • Code examples
        • Add performance max campaign
        • Add performance max retail campaign
        • Add performance max product listing group tree
        • Add performance max for travel goals campaign
    • App campaigns
      • Overview
      • Create campaign
      • Create ad group & ad
      • Code example
      • Reporting
    • Demand Gen campaigns
      • Overview
      • Create campaign
      • Audience targeting
      • Campaigns with product feeds
      • Channel controls
      • Reporting & optimization
    • Local Services campaigns
    • Smart campaigns
      • Overview
      • Get suggestions
      • Create budget
      • Create campaign and campaign setting
      • Create campaign criteria
      • Create ad group and ad group ad
      • Send mutate request
      • Reporting
    • Search campaigns
      • Getting started
    • AI Max for Search campaigns
      • Getting started
    • Video campaigns
  • Manage conversions
    • Overview
    • Conversion action categories
    • Getting started
    • Manage offline conversions
    • Manage online conversions
    • Manage call conversions
    • Manage store sales conversions
    • Modify uploaded conversions
      • Upload conversion adjustments
      • Conversion value rules
    • Custom conversion variables
    • Conversion goals
      • Overview
      • Customer goals
      • Campaign goals
      • Lifecycle goals
    • Monitor Upload Health
    • Reporting
    • Troubleshooting
  • Manage audiences
    • Overview
    • Audiences
    • Get started with audience segments
    • Visitors to your website
    • Visitors to specific pages
    • Visitors who took specific actions
    • Multiple user lists
    • Customer match
      • Get started
      • Manage
      • Troubleshoot
    • Custom audiences
    • Lookalike segments
    • Sample scenario
      • Overview
      • Creating the rule item groups
      • Creating the user list
    • Dynamic Remarketing