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
  • Русский
  • עברית
  • العربيّة
  • فارسی
  • हिंदी
  • বাংলা
  • ภาษาไทย
  • 中文 – 简体
  • 中文 – 繁體
  • 日本語
  • 한국어
Guides Performance Max Videos Reference Reports Libraries & Examples REST Interface Policies Support
Google Ads API
  • Google Ads API
  • Guides
  • Performance Max
  • Videos
  • Reference
  • Reports
  • Libraries & Examples
  • REST Interface
  • Policies
  • Support
  • Client libraries
    • Overview
    • Java
      • Overview
      • Getting started
      • OAuth desktop and web application flows
      • OAuth service account flow
      • Building from source
      • Configuration
      • Logging
      • Field masks
      • Resource names
      • Advanced usage
      • Long-running operations (LROs)
    • .NET
      • Overview
      • Getting started
      • OAuth2 desktop and web application flows
      • OAuth service account flow
      • Configuration
      • Logging
      • Field masks
      • Resource names
      • Protocol buffers
      • Custom gRPC interceptors
      • Performance
    • PHP
      • Overview
      • OAuth2 desktop and web application flows
      • OAuth service account flow
      • Configuration
      • Logging
      • Response Metadata
      • Running in a Docker container
      • Transport
      • Protobuf
      • Proxy
      • Field masks
      • Resource names
      • Performance
      • Timeout
      • Demo apps
      • GAPIC
    • Python
      • Overview
      • Installation
      • Configuration
      • OAuth2 desktop and web application flows
      • OAuth2 service account flow
      • Streaming iterators
      • Proxy
      • Enums, types and services
      • Field masks
      • Logging
      • Optional request headers
      • Resource names
      • Empty message fields
      • Protobuf messages
      • Timeouts
      • Dependencies
    • Ruby
      • Overview
      • OAuth2 desktop and web application flow
      • OAuth service account flow
      • Configuration
      • Logging
      • Timeouts
      • Field masks
      • Resource names
      • Lookup util
      • Factories
    • Perl
      • Overview
      • OAuth2 desktop application flow
      • OAuth2 web application flow
      • OAuth service account flow
      • Configuration
      • Logging
      • Running in a Docker container
      • Proxy
      • Field masks
      • Resource names
      • Performance
  • Code samples
    • Overview
    • Account Management
    • Create customer
    • Get account hierarchy
    • Get change details
    • Get change summary
    • Invite user with access role
    • Link manager to client
    • List accessible customers
    • Update user access
    • Verify advertiser identity
    • Advanced Operations
    • Add ad customizer
    • Add ad group bid modifier
    • Add app campaign
    • Add bidding data exclusion
    • Add bidding seasonality adjustment
    • Add call ad
    • Add display upload ad
    • Add dynamic page feed asset
    • Add dynamic search ads
    • Add Performance Max campaign
    • Add responsive search ad with ad customizer
    • Add smart campaign
    • Create and attach shared keyword set
    • Find and remove criteria from shared set
    • Get ad group bid modifiers
    • Use cross account bidding strategy
    • Use portfolio bidding strategy
    • Assets
    • Add call
    • Add hotel callout
    • Add lead form asset
    • Add prices
    • Add sitelinks
    • Authentication
    • Generate user credentials
    • Basic Operations
    • Add ad groups
    • Add campaigns
    • Get campaigns
    • Get responsive search ads
    • Pause ad
    • Remove campaign
    • Search for Google Ads fields
    • Update ad group
    • Update campaign
    • Update responsive search ad
    • Billing
    • Add account budget proposal
    • Add billing setup
    • Get invoices
    • Campaign Management
    • Add campaign labels
    • Add complete campaigns using batch job
    • Create experiment
    • Get all disapproved ads
    • Set ad parameters
    • Update campaign criterion bid modifier
    • Validate ad
    • Error Handling
    • Handle keyword policy violations
    • Handle partial failure
    • Handle rate exceeded error
    • Handle responsive search ad policy violations
    • Misc
    • Add ad group image asset
    • Campaign report to CSV
    • Set custom client timeouts
    • Upload image asset
    • Planning
    • Forecast reach
    • Generate forecast metrics
    • Generate historical metrics
    • Generate keyword ideas
    • Get ad group criterion CPC bid simulations
    • Recommendations
    • Detect and apply recommendations
    • Dismiss recommendation
    • Remarketing
    • Add conversion action
    • Add conversion based user list
    • Add custom audience
    • Add customer match user list
    • Add dynamic remarketing asset
    • Add flexible rule user list
    • Add logical user list
    • Add merchant center dynamic remarketing campaign
    • Set up advanced remarketing
    • Set up remarketing
    • Update audience target restriction
    • Upload call conversion
    • Upload conversion adjustment
    • Upload enhanced conversions for leads
    • Upload enhanced conversions for web
    • Upload offline conversion
    • Upload store sales transactions
    • Reporting
    • Parallel report download
    • Shopping Ads
    • Add listing scope
    • Add Performance Max product listing group tree
    • Add Performance Max retail campaign
    • Add Shopping product ad
    • Add Shopping product listing group tree
    • Get product category constants
    • Targeting
    • Add campaign targeting criteria
    • Add customer negative criteria
    • Add demographic targeting criteria
    • Get geo target constants by names
    • Travel
    • Add hotel ad
    • Add hotel ad group bid modifiers
    • Add hotel listing group tree
    • Add Performance Max for travel goals campaign
    • Add things to do ad
Interested in sharing your feedback about the Google Ads API? Sign up to be invited to participate in user research!
  • Home
  • Products
  • Google Ads API
  • Libraries & Examples

Overview

The Ruby client library is hosted on GitHub and the gem is available on RubyGems.

The library supports the three most recent Ruby major versions.

To use this library, you must first be familiar with the API basics.

Refer to the library's README for getting started instructions.

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 2025-04-21 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
  • ICP证合字B2-20070004号
  • Manage cookies
  • Sign up for the Google Developers newsletter Subscribe
  • English
  • Deutsch
  • Español
  • Español – América Latina
  • Français
  • Indonesia
  • Italiano
  • Polski
  • Português – Brasil
  • Tiếng Việt
  • Türkçe
  • Русский
  • עברית
  • العربيّة
  • فارسی
  • हिंदी
  • বাংলা
  • ภาษาไทย
  • 中文 – 简体
  • 中文 – 繁體
  • 日本語
  • 한국어