The Search Ads 360 Reporting API enforces limits on API operations to ensure optimal system performance for all users.
Use of the Search Ads 360 Reporting API is included in the overall pricing of Search Ads 360. There are no additional fees for using the API.
The following limits apply to query operations performed through the Search or SearchStream methods.
- 3,000 queries per minute per project per user
- 3,000 queries per minute per project
- 150,000 queries per day per project
Daily API operation limits
Daily API usage limits are based on the number of API operations made per Google Cloud project.
The following table gives some examples of the accounting:
|Operations counted towards Daily Limit
Count: 53 ad groups
Count: 45 campaigns
Requests that violate these limits are rejected with the error:
SearchStream request counts as one operation against the user's
daily operation quota. One
SearchStream request counts as one API operation
irrespective of the number of batches.
All of the Search Ads 360 Reporting API client libraries use gRPC for generating requests and responses. By default, gRPC has a message size of 4 MB, but our client libraries set the max message size to 64 MB in order to increase efficiency.
Responses must not exceed this limit. For example, a search request that includes a lot of fields may generate a response that exceeds 64 MB in size. To avoid this limit, you can reduce the number of selected fields, reduce the page size, or use streaming.
Paginated requests (for example, requests that contain a valid
next_page_token) are not counted against a user's daily operation quota.
However, pagination requests that contain an expired or invalid page token will
generate an exception and will count against the daily operation quota.
Requests that are paginated, such as search requests, are also subject to the
Page size cannot exceed 10,000 rows limitation and are rejected if it violates
this limit, with the error:
For more details on pagination, refer to Paging through results.
Requests that return API exceptions
Requests that are rejected with a
SearchAds360Failure still count against the
user's daily operation quota.
Requests that fail but don't return a
SearchAds360Failure, such as from an error at
the network level, won't count against the user's daily operation quota
since the requests would never reach the service. An example of this is a
network connectivity failure.
Other types of limits
A repeated field, such as a list of operations, that has too many items in a
request can incur the error:
This same error message can also be due to other issues.