Cuotas y límites

Tu cuenta de comercio y tu 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.
• 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 para tus objetos products y accounts según tu uso.

A continuación, te indicamos cómo hacemos un seguimiento de tu uso de 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 de list de 250 elementos una vez, no como 250 solicitudes de 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.
• Las cuotas se aplican al grupo de servicios de comparación de productos (CSS), al CSS, a la cuenta o a las subcuentas en las que te autenticas cuando realizas la llamada. Por ejemplo, si te autenticas como una cuenta avanzada, las llamadas se contabilizarán en la cuota de tu cuenta avanzada, pero si te autenticas como una de tus cuentas secundarias, las llamadas se contabilizarán en la cuota de la cuenta secundaria.

El diagrama muestra la jerarquía de los grupos de CSS, los CSS, las cuentas y las subcuentas.

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

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

• 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 individuales del método de inserción.
• La automatización de las cuotas para las cuentas y los productos sigue vigente.
• Para determinar el uso y los límites actuales de tu cuota, incluidas las automatizaciones y las anulaciones, usa el método Quota.list.

Verifica tus cuotas de llamadas

Para verificar la cuota de llamadas 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 de products y accounts. Si necesitas una cuota mayor para cualquier otro servicio, si estás alcanzando tu cuota diaria para los servicios de products o accounts, o si necesitas un aumento temporal para los productos services o accounts, comunícate con nosotros y proporciona la siguiente información:

• Tu ID de Merchant Center
• Los métodos para 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 que tienes suficiente cuota para tu implementación o para saber cómo se ajusta automáticamente.

Errores

Si excedes 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 uso, y solicitar un aumento de cuota por día o por minuto, consulta Cómo verificar 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 cuenta

Los métodos accounts.limits.get y accounts.limits.list te permiten verificar los límites en 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 del EEE 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 y el alcance del límite. Por ejemplo, products~ADS_EEA para los productos que segmentan anuncios en el EEE y products~ADS_NON_EEA para los productos que segmentan anuncios fuera del EEE.

A continuación, se muestra un ejemplo de solicitud para obtener el límite de 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 Información sobre 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 esta lista de límites puede no estar 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[]