Ads API Client Libraries for Ruby
Ruby Other
Switch branches/tags
dfp_api-0.22.0 dfp_api-0.21.0 dfp_api-0.20.0 dfp_api-0.19.0 dfp_api-0.18.0 dfp_api-0.17.0 dfp_api-0.16.1 dfp_api-0.16.0 dfp_api-0.15.0 dfp_api-0.13.1 dfp_api-0.13.0 dfp_api-0.12.1 dfp_api-0.12.0 dfp_api-0.10.1 dfp_api-0.10.0 dfp_api-0.9.5 dfp_api-0.9.4 dfp_api-0.9.3 dfp_api-0.9.2 dfp_api-0.9.1 dfp_api-0.9.0 dfp_api-0.8.1 dfp_api-0.8.0 dfp_api-0.7.1 dfp_api-0.7.0 dfp_api-0.6.3 dfp_api-0.6.2 dfp_api-0.6.0 dfp_api-0.5.0 dfp_api-0.3.3 dfp_api-0.3.2 dfp_api-0.3.1 dfp_api-0.3.0 dfp_api-0.2.8 dfp_api-0.2.7 dfp_api-0.2.6 adx_buyer_api-0.5.1 adx_buyer_api-0.4.5 adx_buyer_api-0.4.4 adwords_api-0.25.1 adwords_api-0.25.0 adwords_api-0.24.1 adwords_api-0.24.0 adwords_api-0.23.1 adwords_api-0.22.0 adwords_api-0.21.1 adwords_api-0.21.0 adwords_api-0.20.1 adwords_api-0.20.0 adwords_api-0.19.1 adwords_api-0.19.0 adwords_api-0.18.3 adwords_api-0.18.1 adwords_api-0.18.0 adwords_api-0.17.0 adwords_api-0.16.1 adwords_api-0.16.0 adwords_api-0.15.2 adwords_api-0.15.1 adwords_api-0.15.0 adwords_api-0.14.2 adwords_api-0.14.1 adwords_api-0.14.0 adwords_api-0.13.2 adwords_api-0.13.1 adwords_api-0.13.0 adwords_api-0.12.1 adwords_api-0.12.0 adwords_api-0.11.1 adwords_api-0.11.0 adwords_api-0.10.0 adwords_api-0.9.3 adwords_api-0.9.2 adwords_api-0.9.0 adwords_api-0.8.2 adwords_api-0.8.1 adwords_api-0.8.0 adwords_api-0.7.0 adwords_api-0.6.3 adwords_api-0.6.2 adwords_api-0.6.1 adwords_api-0.6.0 adwords_api-0.5.3 adwords_api-0.5.0 adwords_api-0.4.5 adwords_api-0.4.4 ads_savon-1.0.2 ads_savon-1.0.1 ads_savon-1.0.0 ads_common-0.14.1 ads_common-0.14.0 ads_common-0.13.0 ads_common-0.12.6 ads_common-0.12.5 ads_common-0.12.4 ads_common-0.12.3 ads_common-0.12.2 ads_common-0.12.1 ads_common-0.12.0 ads_common-0.11.3
Nothing to show
Latest commit ef9e7f6 Aug 16, 2017 @donovanfm donovanfm Commiting latest changes.

Ads API Client Libraries for Ruby

This project hosts the new Ads common framework for Ruby, as well as the Ruby client libraries for the various SOAP-based Ads APIs at Google.

The Ruby client libraries make it easier to write Ruby clients to programmatically access your accounts.

New to the library? Take a look at the wiki for this project.

Want to stay up-to-date with our latest releases? Subscribe to the master RSS feed on GitHub.

Products currently supported

  • Google AdWords API AdWords Gem Version
  • Google's DoubleClick For Publishers API DFP Gem Version

Client library features

  • Support for logging incoming and outgoing SOAP messages
  • Support for logging request information
  • Based on Savon library
  • Ruby 2.1, 2.2, 2.3, and 2.4 compatible
  • OAuth2 and OAuth2 JWT built-in authentication
  • Local validation for parameter number and type on API calls
  • Thread-safe
  • Ruby-like syntax, by converting all method names and properties to snake_case instead of lowerCamelCase
  • Simplified development model by using arrays and hashes instead of solid objects
  • (AdWords) Full support for reporting and BatchJobService uploads

Getting started

  1. Install your library of choice using RubyGems.

     $ gem install google-adwords-api


     $ gem install google-dfp-api

    Note: If you're using a version of Ruby lower than 2.2.2, you will need to manually install a previous version of Rack, a dependency of our HTTP library. You can do this with:

     $ gem install rack -v 1.6.4
  2. Copy the sample config file (adwords_api.yml or dfp_api.yml) for your product to your home directory and fill out the required properties.

  1. Setup your OAuth2 credentials.

The AdWords and DoubleClick for Publishers APIs use OAuth2 as the authentication mechanism. Follow the appropriate guide below based on your use case.

If you're accessing an API using your own credentials...

If you're accessing an API on behalf of clients...

  1. See each product's individual README for more specific instructions:

Submitting bug reports and/or feature requests

If you have issues directly related to the client library, use the issue tracker.

If you have issues pertaining to a specific product, use the product support forums:

Make sure to subscribe to our blog for API change announcements and other news.


To enable logging, see the library-specific README files for AdWords or DFP.



See for details on how to contribute.

Note: if you have an ad blocker active, you might experience issues while submitting an issue or pull request. You can still contribute by disabling the ad blocker for this project URL.