Performance

  • Performance of the Perl client library for the Google Ads API depends on how it is used and integrated.

  • Profiling your application for CPU and memory usage can identify performance bottlenecks, and Devel::NYTProf is a useful tool for this.

  • Regularly upgrading to a newer Perl version is recommended for better overall performance.

  • Setting the logging level to WARN for production code is advised to avoid performance penalties from extensive logging.

  • SearchStream generally offers better performance than Search for retrieving objects, although there may be specific scenarios where Search is preferred.

  • HTTP timeouts can be set on the client level, and for extremely long-running requests that might time out, splitting the request into parallel chunks is recommended.

The client library for Perl eases interactions with the Google Ads API, with minimal configuration on your part. However, performance highly depends on how the library is used and integrated.

Most of these best practices are applicable to all languages. This guide goes through the ones that are specific to Perl.

Profiling your application

Profile your application both for CPU and memory usage to identify performance bottlenecks. Devel::NYTProf is a powerful feature-rich Perl source code profiler that you can explore.

Perl version

It is a good practice to regularly upgrade to a newer Perl version as it usually comes with better overall performance. See here for the latest Perl version, and the minimum required version for the library in this page.

Logging

Extensive logging can incur significant execution time penalties and memory consumption. We recommend setting the logging level to WARN for any code in production.

See the Logging guide for more details about the configuration of summary and detail loggers.

Search or SearchStream method

Google Ads API provides two main methods to retrieve objects -- Search (which uses pagination) and SearchStream (which uses streaming). SearchStream provides better performance over Search method, but there might be certain scenarios where Search method might be preferred.

You can learn more about the two methods here.

HTTP timeout

The Perl client library provides a surface for setting HTTP timeouts on the client level:

my $api_client = Google::Ads::GoogleAds::GoogleAdsClient->new({
  # Set HTTP timeout to 5 minutes.
  http_timeout   => 300
});

The default value is set based on the DEFAULT_HTTP_TIMEOUT setting in Constants.pm. Set a lower value if you need to enforce a shorter limit on the maximum time for an API call.

You can set the timeout to 2 hours or more, but the API may still time out extremely long-running requests and return a DEADLINE_EXCEEDED error. If you encounter that error, split the request up and execute the chunks in parallel; this avoids the situation where a long running request fails and the only way to recover is to trigger the request again from the start.