Google Ads API Now Implements Throttle on Resource Usage

The Google Ads API resource usage policy is being updated to throttle GoogleAdsService.Search and GoogleAdsService.SearchStream query patterns that consume excessive amounts of API resources. This means that certain query patterns that use up too many resources will be limited, but other services, methods, and query patterns will remain unaffected.

The new throttling for query patterns in the Google Ads API will start the week of June 17, 2024.

To handle the new error codes due to throttling in the Google Ads API:

• If using version v16 or older, handle QuotaError.RESOURCE_TEMPORARILY_EXHAUSTED errors.
• If using version v17 or later, handle QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION and QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION errors.

To improve query performance and avoid throttling in the Google Ads API:

• Run the query less frequently.
• Use a less expensive query pattern or view.
• For more optimization tips, see the manage data efficiency section.

The query_resource_consumption metric is introduced to help identify and monitor expensive reports in the Google Ads API. It provides a cost metric for individual reports, which can be viewed in the SearchGoogleAdsResponse.query_resource_consumption field for the GoogleAdsService.Search method, and in the SearchGoogleAdsStreamResponse.query_resource_consumption field for the GoogleAdsService.SearchStream method. This metric can be incorporated into monitoring systems to detect and handle new expensive queries.