REST Interface

Key Point: We strongly recommend using our official client libraries wherever you can. All Google provided client libraries are implemented using gRPC, except for the Perl library, which uses the REST interface. Unless you are specifically looking for details about REST, consult the gRPC documentation for reference documentation that covers our official client libraries.

The Google Ads API can be called either using gRPC or REST. Both interfaces expose a resource-oriented design shared with other Google Cloud APIs.

We recommend using Google's official client libraries wherever possible. They provide idiomatic, type-safe code in each supported language and handle many low-level details of communication with the API (like timeout settings, result set pagination, and authentication). Our client libraries also include an extensive set of code examples and utilities that assist with common tasks, such as constructing resource names and handling field masks.

This guide presents details specific to REST and explains what you need to know to call the REST interface directly, without the use of a Google-supported client library. This guide may be useful if you are writing your own custom code to use REST directly or using a third-party HTTP client library.