Try out the REST interface
Stay organized with collections
Save and categorize content based on your preferences.
AI-generated Key Takeaways
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.
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, for instance when you want to test the
behavior of an endpoint or to debug a request.
For these situations, the reference pages for REST endpoints provide a
Try it! button which you can use to send a single request to the Google Ads API
to verify its behavior.
To use it, you need your developer token and the customer ID for the
account you want to issue the request against. Access to that account is also
required since you have to authenticate with a Google account using OAuth.
Once you have these, you can visit a REST reference page, like the one for the
customers.googleAds/search
endpoint, and click the Try it! button on the right to send your request.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-10-24 UTC."],[],[]]