Stay organized with collections
Save and categorize content based on your preferences.
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.
[null,null,["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eGoogle strongly recommends using their official client libraries for Google Ads API interaction, which are primarily based on gRPC.\u003c/p\u003e\n"],["\u003cp\u003eFor one-time requests or debugging, the REST interface is available with a "Try it!" feature on reference pages for testing.\u003c/p\u003e\n"],["\u003cp\u003eUsing the "Try it!" functionality requires a developer token, customer ID, and Google account authentication via OAuth.\u003c/p\u003e\n"]]],[],null,["# Try out the REST interface\n\n| **Key Point:** We strongly recommend using our [official client\n| libraries](/google-ads/api/docs/client-libs) wherever you can. All Google provided client libraries are implemented using gRPC, except for the [Perl\n| library](https://github.com/googleads/google-ads-perl/) which uses the REST interface. Unless you are specifically looking for details about REST, consult the [gRPC\n| documentation](/google-ads/api/reference/rpc) for reference documentation that covers our official client libraries.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nWhile we recommend using Google's official [client\nlibraries](/google-ads/api/docs/client-libs) wherever possible for application development,\nthe REST interface can be useful in cases where you just want to issue a\none-time request to the Google Ads API, for instance when you want to test the\nbehavior of an endpoint or to debug a request.\n\nFor these situations, the reference pages for REST endpoints provide a\n**Try it!** button which you can use to send a single request to the Google Ads API\nto verify its behavior.\n\nTo use it, you need your **developer token** and the **customer ID** for the\naccount you want to issue the request against. Access to that account is also\nrequired since you have to authenticate with a Google account using OAuth.\n\nOnce you have these, you can visit a REST reference page, like the one for the\n[`customers.googleAds/search`](/google-ads/api/rest/reference/rest/v21/customers.googleAds/search)\nendpoint, and click the **Try it!** button on the right to send your request."]]
