Google Ads API is returning to beta status. Please read our blog post for more details.

Client Libraries

Our client libraries provide high-level views and basic building blocks of Google Ads API functionality, making it easier to develop apps quickly. We recommend starting out with one if you're new to the API.

Client library Source Distribution Code examples
Java google-ads-java Maven, tar.gz View on GitHub
.NET google-ads-dotnet tar.gz, zip View on GitHub
PHP google-ads-php tar.gz View on GitHub
Python google-ads-python tar.gz, zip View on GitHub
Ruby google-ads-ruby gem, tar.gz, zip View on GitHub

Diagnostic Tool

Google Ads Doctor analyzes your client library environment by

  • verifying your OAuth2 credentials with Google Ads API.
  • guiding you through fixing any OAuth2 problems in your configuration file.

You can download a binary for diagnosing your issues immediately:

Architecture Windows Linux Mac OS X
x86 (32-bit) Download Download Download
x86-64 (64-bit) Download Download Download

Code Samples

You can also view the code examples here, directly. Just click on an example below and then select the language tab of your choice. A link to its GitHub source can be found at the end of each sample.

Account Management

Advanced Operations


Basic Operations


Campaign Management

Hotel Ads




Shopping Ads