Try out the REST interface

Page Summary

• It is recommended to use official client libraries for application development, which are mostly implemented using gRPC.

• The REST interface is useful for one-time requests, testing endpoints, or debugging requests.

• REST reference pages provide a "Try it!" button to send single requests to the Google Ads API.

• Using the "Try it!" feature requires a developer token, customer ID, and authenticated access to the account via OAuth.

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.

Note: If you are new to the Google Ads API, we recommend reading the Getting Started guide first, which covers how to set up your account and make your first API call. Make sure to follow the curl tab.

While we recommend using Google's official client libraries wherever possible for application development, the REST interface can be useful in cases where you just want to issue a one-time request to the Google Ads API, such as when you want to test the behavior of an endpoint or to debug a request.

For these situations, the reference pages provide an interactive Google Ads API Explorer (Try this method panel) that you can use to send a single request to the Google Ads API to verify its behavior.

To use it, you need the customer ID for the account you want to issue the request against. Access to that account is also required so you can authenticate with a Google Account using OAuth (plus a login-customer-id header if accessing the account through a manager account; developer tokens were sunset on September 9, 2026 and are optional).

Once you have these details, visit a reference page such as GoogleAdsService/Search and use the Try this method panel on the right to send your request.