The Ruby client library is hosted [on GitHub](https://github.com/googleads/google-ads-ruby) and the gem is
available on [RubyGems](https://rubygems.org/gems/google-ads-googleads).

The library supports actively maintained [Ruby releases](https://www.ruby-lang.org/en/downloads/releases/) (Ruby
3.2, 3.3, and 3.4, with a gemspec requirement of Ruby 3.0 or later).

## Make your first API call

To use the Google Ads API, you need to perform several steps to get access to the API
and configure your Google Ads accounts. The
[quick start guide](https://developers.google.com/google-ads/api/docs/get-started/make-first-call.md.txt) walks you through all
the important steps, including setting up your Google Ads accounts.

## Basic usage

Refer to the [basic usage guide](https://developers.google.com/google-ads/api/docs/client-libs/ruby/basic-usage.md.txt) to learn more about how to use the
Ruby client library:

```ruby
# Optional when using Bundler.require in v41.1.0 and later:
require 'google/ads/google_ads'

# Initialize the client using your ~/google_ads_config.rb configuration file.
client = Google::Ads::GoogleAds::GoogleAdsClient.new

# Access a specific service.
customer_service = client.service.customer
```

## Authorization and authentication

The Ruby client library supports multiple approaches to authentication and
authorization. Refer to the [authorization and authentication](https://developers.google.com/google-ads/api/docs/client-libs/ruby/authentication.md.txt)
guide to learn more.

## Configuration and logging

The Ruby client library supports multiple [configuration](https://developers.google.com/google-ads/api/docs/client-libs/ruby/configuration.md.txt) and
[logging](https://developers.google.com/google-ads/api/docs/client-libs/ruby/logging.md.txt) options. Each service's [timeout and retry](https://developers.google.com/google-ads/api/docs/client-libs/ruby/timeouts.md.txt) periods
can be overridden as well.

## Utilities

The Ruby client library includes several utility classes to improve API
usability. Refer to the following guides to learn more:

- [Field masks](https://developers.google.com/google-ads/api/docs/client-libs/ruby/field-masks.md.txt)
- [Resource names](https://developers.google.com/google-ads/api/docs/client-libs/ruby/resource-names.md.txt)
- [Lookup utility](https://developers.google.com/google-ads/api/docs/client-libs/ruby/lookup-util.md.txt)
- [Factories](https://developers.google.com/google-ads/api/docs/client-libs/ruby/factories.md.txt)