Cuotas y límites

Las funciones de la API de Merchant tienen cuotas y límites estrictos.

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.
  • Solo puedes actualizar tus cuentas secundarias una vez al día.

Cuotas de llamadas a métodos

La API de Merchant ajusta automáticamente las cuotas de llamadas de tu products y accounts según tu uso.

A continuación, te indicamos cómo hacemos un seguimiento del uso de tu cuota:

  • Las cuotas son por método. Por ejemplo, el método get tiene una cuota distinta 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.
  • 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 consideran en la cuota de la cuenta avanzada, pero si te autenticas como una de tus cuentas secundarias, las llamadas se consideran en la cuota de la cuenta secundaria.

El diagrama muestra la jerarquía de los grupos de CSS, los CSS, las cuentas y las cuentas secundarias. En la imagen, se muestra que un grupo de CSS es un nivel de autenticación general, con la posibilidad de incluir CSS individuales, cuentas dentro de ellos y cuentas secundarias como el nivel más individual.

Verifica tus cuotas

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

La cuota automática solo se aplica a los servicios products y accounts. Si necesitas un aumento de la cuota de cualquier otro servicio, alcanzaste tu cuota diaria de los servicios de products o accounts, o necesitas un aumento temporal de accounts o los productos services, comunícate con nosotros y envíanos la siguiente información:

  • 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 una cantidad suficiente para tu implementación o de cómo se ajusta automáticamente.

Errores

Si superas las cuotas, recibirás los siguientes errores:

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

Para ver tus cuotas y el uso, y solicitar un aumento de cuota por día o por minuto, consulta Cómo consultar tus cuotas.

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

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

Límites de representación de recursos

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

Ten en cuenta que esta lista de límites puede no estar completa. No extenderemos estos límites.

Recurso Campo Límite
shippingsettings

Servicios de envío por país (services).

Grupos de envío por servicio de envío (rateGroups).

Etiquetas por grupo de envío (applicableShippingLabels).

Subtablas por grupo de envío (subtables).

Cantidad de filas o columnas en una sola tabla de tarifas.

Es la longitud de las etiquetas de envío.

20

20

30

100

150

100

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[]