The REST interface overviewStay organized with collectionsSave and categorize content based on your preferences.
Page Summary
We strongly recommend using the official client libraries, which are implemented using gRPC except for the Perl library.
The Google Ads API supports calls via either gRPC or REST interfaces, both utilizing a resource-oriented design.
Official client libraries are recommended for their idiomatic, type-safe code and handling of low-level communication details.
This guide specifically details how to call the REST interface directly without using a Google-supported client library.
The Google Ads API can be called either usinggRPCor REST. Both
interfaces expose aresource-oriented designshared with other Google Cloud APIs.
We recommend using Google's officialclient librarieswherever 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 setpagination, andauthentication). Our client libraries also include an
extensive set ofcode examplesand utilities that assist with
common tasks, such as constructingresource namesand handlingfield 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.
[[["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-12-03 UTC."],[],["The Google Ads API utilizes gRPC or REST interfaces, sharing a resource-oriented design. Using Google's client libraries is highly recommended for type-safe code, handling communication details like timeouts, pagination, and authentication. The official client libraries use gRPC, except for the Perl library, which uses REST. This guide details using REST directly without client libraries, useful for custom code or third-party HTTP clients. It focuses on information outside of what the official client libraries cover.\n"]]
