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
Perl	google-ads-perl	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.

Follow these steps to download the command-line tool for diagnosing your issues immediately:

Linux (64-bit)

    git clone https://github.com/googleads/google-ads-doctor.git
    cd google-ads-doctor/oauthdoctor/bin/linux/amd64
    ./oauthdoctor -language [java|dotnet|php|python|ruby] \
      -oauthtype [web|installed_app|service_account] \
      -configpath [/my/config/file/path] \
      -verbose

Windows (64-bit)

    git clone https://github.com/googleads/google-ads-doctor.git
    cd google-ads-doctor/oauthdoctor/bin/windows/amd64
    ./oauthdoctor.exe -language [java|dotnet|php|python|ruby] \
      -oauthtype [web|installed_app|service_account] \
      -configpath [/my/config/file/path] \
      -verbose

Mac OS X (64-bit)

    git clone https://github.com/googleads/google-ads-doctor.git
    cd google-ads-doctor/oauthdoctor/bin/darwin/amd64
    ./oauthdoctor -language [java|dotnet|php|python|ruby] \
      -oauthtype [web|installed_app|service_account] \
      -configpath [/my/config/file/path] \
      -verbose

Linux (32-bit)

    git clone https://github.com/googleads/google-ads-doctor.git
    cd google-ads-doctor/oauthdoctor/bin/linux/386
    ./oauthdoctor -language [java|dotnet|php|python|ruby] \
      -oauthtype [web|installed_app|service_account] \
      -configpath [/my/config/file/path] \
      -verbose

Windows (32-bit)

    git clone https://github.com/googleads/google-ads-doctor.git
    cd google-ads-doctor/oauthdoctor/bin/windows/386
    ./oauthdoctor.exe -language [java|dotnet|php|python|ruby] \
      -oauthtype [web|installed_app|service_account] \
      -configpath [/my/config/file/path] \
      -verbose

Mac OS X (32-bit)

    git clone https://github.com/googleads/google-ads-doctor.git
    cd google-ads-doctor/oauthdoctor/bin/darwin/386
    ./oauthdoctor -language [java|dotnet|php|python|ruby] \
      -oauthtype [web|installed_app|service_account] \
      -configpath [/my/config/file/path] \
      -verbose

To get additional options with the tool, you either read the README or run this command:

Linux / Mac OS X

    ./oauthdoctor -help

Windows

    ./oauthdoctor.exe -help

Code examples

Check out our code examples of some common functions in the Google Ads API.