Google Ads API Client Library for Java

  • The Google Ads API client library for Java is open-source, available on GitHub, and distributed via Maven for easy integration into your projects.

  • It simplifies interactions with the Google Ads API, offering features like credential management and service client creation, while requiring Java 1.8+ for compatibility.

  • Comprehensive guides and documentation are available to assist with setup, authorization using various OAuth flows, building from source, and other library functionalities.

  • Developers can leverage resources for advanced usage including configuration files, logging, field masks, resource names, proxy settings, and managing long-running operations.

  • A dedicated video library provides a visual guide to get started with the Java client library and its core features.

The client library for Java is hosted on GitHub and distributed through Maven. It offers several features to help you use the API, including easier management of credentials and creation of Google Ads API service clients.

The library requires Java 1.8+.

Video library: Getting started with the Java client library

Guides

Getting started
Setup instructions for the library.
Authorization

Instructions on configuring OAuth2 credentials for the library using different authorization flows.

OAuth desktop application flow
How to get OAuth2 refresh tokens for desktop apps.
OAuth web application flow
How to get OAuth2 refresh tokens for web apps.
OAuth service account flow
How to use OAuth2 with service account credentials.
Build from source

How to build the client library from source.

Configuration file format

How to specify Java properties.

Logging

How to set up logging.

Field masks

How to use field masks in update operations.

Resource names

Form and usage of resource names in the API.

Proxy configuration

Configure a HTTP(S) proxy.

Long-running operations

Run long-running operations.