This is the documentation for Recommendations AI, Retail Search, and the new Retail console. To use Retail Search in the restricted GA phase, contact Cloud sales.

If you are only using Recommendations AI, remain on the Recommendations console and refer to the Recommendations AI documentation.

Quotas and limits

This page provides information about Retail API quotas and limits.

Default quotas

By default, your project has the following Retail quotas:

Quota Value
User event writes per minute 60,000
User event imports per minute 100
User event writes per user per minute 240
User event reads per minute 300
Product writes per minute 12,000
Product imports per minute 100
Product reads per minute 300
Predictions per minute 60,000
Predictions per minute for a specific user 60,000
Searches per minute 300
Completion read per minute 300
Total user events 40,000,000,000
Total products 40,000,000
Total tags
(sum of per-product tag counts, not unique tags)
100,000,000
Pending Cloud Storage import long running operations 300
Pending BigQuery import long running operations 100
Pending Merchant Center import long running operations 10
Concurrent active models 10
Total models (active and paused) 20
Total placements 100

Checking your quotas

To check the current quotas for Retail resources in your project, go to the Quotas page in the Google Cloud Console and select Retail in the Services dropdown list.

You can see recent quota usage by going to the API Dashboard, selecting the Retail API, and opening the Quotas tab.

Increasing your quotas

As your use of Google Cloud expands over time, your quotas can increase accordingly. If you expect a notable upcoming increase in usage, you should make your request a few days in advance to ensure your quotas are adequately sized.

  1. In the Quotas page, select Retail in the Services dropdown list.

  2. Select the quotas you want to change.

  3. Click EDIT QUOTAS.

  4. Fill out your name, email, and phone number and click Next.

  5. Fill in your quota request and click Submit request.

You will receive a response from the Retail team within 48 hours of your request.

Limits

The Retail API enforces the following limits:

  • You can start up to 5 model operations per minute. Limited model operations include creation, deletion, pause, and resume.

  • Your site can have up to 250,000 user event writes per visitor ID or user ID per week.

  • Your site can have up to 10,000 product writes per product ID per week.