Cuotas y límites

Tu cuenta de comerciante y el uso de la API de Merchant están sujetos a cuotas y límites.

Actualizar política

La API de Merchant aplica las siguientes políticas en términos de actualizaciones:

• Solo puedes actualizar tus productos hasta dos veces al día. Debes distribuir las llamadas diarias de manera uniforme a lo largo del día para cumplir con la cuota por minuto.
• Solo puedes actualizar tus cuentas secundarias hasta dos veces al día.
• Solo puedes llamar a los métodos de fuentes de datos para tus cuentas secundarias, como list o create, hasta dos veces por cuenta secundaria al día.

Cuotas de llamadas de método

La API de Merchant ajusta automáticamente las cuotas de llamadas para lo siguiente:

• products y accounts según tu uso
• datasources para cuentas avanzadas según la cantidad de sus cuentas secundarias

Así es como hacemos un seguimiento del uso de tu cuota:

• Las cuotas son por método. Por ejemplo, el método get tiene una cuota independiente del método update.
• Cada solicitud se cuenta una vez, independientemente de su tipo. Por ejemplo, contamos una solicitud list de 250 elementos una vez, no como 250 solicitudes get.
• La cuota se cobra según el usuario que realiza la solicitud a la API. Si el usuario es miembro directo de una cuenta avanzada, la cuota se cobrará a nivel de la cuenta avanzada.
• Para el servicio datasources, el ajuste automático de cuotas solo se aplica a las cuentas avanzadas según la cantidad de sus cuentas secundarias. Las cuotas para las cuentas independientes y las cuentas secundarias son estáticas, y, por lo general, no se admiten aumentos. Para verificar los límites de cuota de datasource, usa los accounts.limits métodos.
• Las cuotas se aplican al grupo de servicios de comparación de productos (CSS), al CSS, a la cuenta o a las cuentas secundarias con las que te autenticas cuando realizas la llamada. Por ejemplo, si te autenticas como una cuenta avanzada, las llamadas se cuentan en la cuota de tu cuenta avanzada, pero si te autenticas como una de tus cuentas secundarias, las llamadas se cuentan en la cuota de la cuenta secundaria.

En el diagrama, se muestra la jerarquía de los grupos de CSS, el CSS, las cuentas y las cuentas secundarias.

Cambios en la cuota de llamadas de método de la Content API for Shopping

Si usaste Content API for Shopping, ten en cuenta los siguientes cambios en la cuota de llamadas de método en la API de Merchant:

• La ausencia de procesamiento por lotes personalizado no afecta el cálculo de la cuota. Por ejemplo, una solicitud por lotes que contiene 500 solicitudes de inserción se cobra como 500 solicitudes de método de inserción individuales.
• La automatización de cuotas para cuentas y productos permanece vigente.
• Para determinar el uso y los límites de tu cuota actual, incluidos la automatización y las anulaciones, usa el método Quota.list.

Verifica tus cuotas de llamadas

Para verificar las cuotas de llamadas y el uso actuales de una cuenta, llama a quotas.list con el name de la cuenta.

La cuota automática se aplica a los servicios products, accounts y datasources.

• Para los recursos con cuotas automáticas (products, accounts y datasources para cuentas avanzadas): Puedes solicitar solo un aumento temporal para situaciones especiales, como el lanzamiento en un mercado nuevo o durante las temporadas de compras de mucho tráfico. No aceptamos aumentos de cuota permanentes para este tipo de recursos.
• Para todos los demás recursos sin cuotas automáticas: Puedes solicitar aumentos de cuota según sea necesario.

Usa el problema Quota increase request del formulario de contacto con el equipo de asistencia y completa los siguientes datos:

• Tu ID de Merchant Center
• Los métodos en los que alcanzaste los límites de cuota
• Una estimación de la cantidad de llamadas por día que necesitas para esos métodos
• El motivo por el que necesitas un aumento de cuota
• Si es un aumento temporal o permanente

Te recomendamos que revises tus cuotas periódicamente para asegurarte de tener suficiente cuota para tu implementación o cómo se ajusta automáticamente tu cuota.

Errores

Si superas la cuota, recibirás los siguientes errores:

• Por minuto: quota/request_rate_too_high
• Por día: quota/daily_limit_exceeded

Para ver tu cuota y uso, y solicitar un aumento de cuota por día o por minuto, consulta Verifica tus cuotas de llamadas.

Los siguientes errores no se pueden resolver con aumentos automáticos de cuota, y requieren que solicites cuota adicional para artículos, feeds o cuentas secundarias:

• too_many_items: Merchant quota exceeded
• too_many_subaccounts: Maximum number of sub-accounts reached

Límites de la cuenta

Los métodos accounts.limits.get y accounts.limits.list te permiten verificar los límites de las entidades a nivel de la cuenta. Puedes usar estos métodos para verificar los límites de productos.

Para recuperar un límite de producto específico, por ejemplo, para obtener la cuota de EEA de Google Ads de una cuenta, debes especificar el ID de la cuenta y el ID del límite en tu llamada a accounts.limits.get. El ID del límite es una combinación del tipo de límite y el alcance. Por ejemplo, products~ADS_EEA para productos segmentados a anuncios en el EEE y products~ADS_NON_EEA para productos segmentados a anuncios fuera del EEE.

A continuación, se muestra una solicitud de ejemplo para obtener el límite products~ADS_EEA para una cuenta determinada:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits/products~ADS_EEA

Para obtener información sobre los IDs de límite disponibles para tu cuenta, usa accounts.limits.list con un filtro para type="products":

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits?filter=type%3D%22products%22

Para obtener más información sobre las cuotas de productos, consulta Comprende las cuotas en Google Merchant Center.

Límites de representación de recursos

En los siguientes límites, se describen restricciones notables para ciertos valores de cadenas y campos de array dentro de las representaciones de recursos que se usan en la API de Merchant. Estos límites son los mismos para la API de Merchant y su función correspondiente en Merchant Center.

Ten en cuenta que es posible que esta lista de límites no esté completa. No extenderemos estos límites.

La cantidad de filas o columnas en una tabla de tarifas afecta los siguientes campos de array:

• Campos de array dentro de rowHeaders o columnHeaders:
  • prices[]
  • weights[]
  • numberOfItems[]
  • postalCodeGroupNames[]
  • locations[]
  • rows[]
  • cells[]