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.

Please 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 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 Get account changes Get account information Advanced Operations Add ad customizer Add ad group bid modifier Add expanded text ad with upgraded urls Create and attach shared keyword set Find and remove criteria from shared set Get ad group bid modifiers Use portfolio bidding strategy Authentication Authenticate in standalone application Authenticate in web application Basic Operations Add ad groups Add campaigns Add expanded text ads Add keywords Get ad groups Get artifact metadata Get campaigns Get expanded text ads Get keywords Pause ad Remove ad Remove ad group Remove campaign Remove keyword Update ad group Update campaign Update keyword Billing Add account budget proposal Get account budget proposals Get account budgets Get billing setup Remove billing setup

Campaign Management Add campaign bid modifier Get all disapproved ads Hotel Ads Add hotel ad Add hotel ad group bid modifiers Planning Add keyword plan Generate forecast metrics Generate keyword ideas Recommendations Apply recommendation Dismiss recommendation Get text ad recommendations Remarketing Add conversion action Reporting Get hotel ads performance Get keyword stats Shopping Ads Add shopping product ad Add shopping product listing group tree Add shopping smart ad Targeting Add campaign targeting criteria Get campaign targeting criteria Get geo target constant by name