Cuotas y límites

Tu cuenta de comerciante 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. Debes distribuir las llamadas diarias de manera uniforme durante el día para cumplir con la cuota por minuto.
• Solo puedes actualizar tus cuentas secundarias una vez al día.

Cuotas de llamadas de método

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

Así es como hacemos un seguimiento de tu uso de la 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.
• 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 en su lugar.
• 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 solo se aplica a los servicios products y accounts. Si necesitas una cuota mayor para cualquier otro servicio, estás alcanzando tu cuota diaria para los products o accounts servicios, o necesitas un aumento temporal para los accounts o los productos services, comunícate con nosotros con 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 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 los 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 de límite y el alcance. Por ejemplo, products~ADS_EEA para productos que segmentan anuncios en el EEE y products~ADS_NON_EEA para productos que segmentan anuncios fuera del EEE.

A continuación, se muestra una solicitud de ejemplo para obtener el límite products~ADS_EEA de 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 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[]