The Perl Client Library

The Perl client library is hosted on GitHub, and the package is available on CPAN.

The library now supports Perl version 5.28.1 or greater. To use this library, you will need the information listed in Prerequisites.

REST API protocol

The class entities (service, resource, enum, error, etc.) in the Perl client library are generated by parsing the protocol buffer definitions. You can read more on protocol buffers to understand how structured data is serialized.

To connect with the Google Ads API, the client library creates the body of HTTP request as a JSON object, sends it to the REST endpoint over HTTP 1.1, deserializes the response as a JSON object, and interprets the results.

Using the client library

See Getting started and Basic usage to start using this library.

To get OAuth2 refresh tokens, visit the following guides:

• OAuth desktop application flow
• OAuth web application flow

To make API calls using OAuth2 service accounts, visit the OAuth service account flow guide.

Visit the following guides for the library's features and utilities:

• Configuration
• Logging
• Running in a Docker container
• Proxy configuration
• Field masks
• Resource names