googleapis/google/ads/googleads

Google Ads API

This folder contains the protocol buffer definitions and experimental build files (see below) for the Google Ads API.

To use this API, we encourage you to take a look at our official client libraries for Java, Ruby, PHP, Python or .NET. Refer to the Quickstart to learn how to make your first API call.

To develop in a programming language without an official client library, refer to the API Concepts Guide and consult these protocol buffer definitions as a reference when constructing API requests.

Use the official Google Ads API forum to request an official client library in another programming language, report bugs, request new features in the Google Ads API, or provide feedback.

Build files (experimental)

IMPORTANT The Bazel build files are experimental. The structure and content of the Bazel packages are subject to change, and the resulting generated API clients are not officially supported Google products.

The Bazel build files contain targets for building generated API clients (GAPICs) from the Google Ads API protocol buffer descriptors. Our officially supported client libraries are built upon these GAPIC artifacts, but add significant performance and usability enhancements. Thus, we strongly recommend using an official client library.

However, developers looking to understand the internals of the API's client libraries or build their own custom gRPC-based clients can use these build files as reference points.

For details on using these files, see the Bazel section of the repository's main README.md.