Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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.
Cambios relacionados con la cuota entre Merchant API y Content API for Shopping
La cuota se contará por recurso, no por método. Esto significa que algunos servicios ahora están vinculados.
La ausencia de lotes personalizados no afecta el cálculo de la cuota. Por ejemplo, una solicitud por lotes que contiene 500 solicitudes de inserción se cobrará como 500 solicitudes individuales del método de inserción.
La automatización de cuotas para cuentas y productos se mantendrá.
Para determinar el uso y los límites actuales de tu cuota, incluidas la automatización y
las anulaciones, usa el método Quota.list.
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.
La cuota se cobra en función del 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 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.
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.
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 cadenas 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 Merchant API 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.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-08 (UTC)"],[[["\u003cp\u003eMerchant API utilizes automatic quota adjustments for \u003ccode\u003eproducts\u003c/code\u003e and \u003ccode\u003eaccounts\u003c/code\u003e services based on usage, tracking requests per-method and applying quotas to specific CSS groups or accounts.\u003c/p\u003e\n"],["\u003cp\u003eUpdates are limited to twice per day for products and once per day for sub-accounts.\u003c/p\u003e\n"],["\u003cp\u003eYou can request quota increases for services other than \u003ccode\u003eproducts\u003c/code\u003e and \u003ccode\u003eaccounts\u003c/code\u003e, exceeding daily quotas, or requiring temporary increases by contacting Google Merchant Center support.\u003c/p\u003e\n"],["\u003cp\u003eExceeding quotas results in specific errors, such as \u003ccode\u003equota/request_rate_too_high\u003c/code\u003e (per minute) and \u003ccode\u003equota/daily_limit_exceeded\u003c/code\u003e (per day), with instructions for checking and requesting increases.\u003c/p\u003e\n"],["\u003cp\u003eResource representations have inherent limits, notably affecting \u003ccode\u003eshippingsettings\u003c/code\u003e with restrictions on shipping services, groups, labels, and table dimensions.\u003c/p\u003e\n"]]],[],null,["# Quotas and limits\n\nMerchant API features carry strict quotas and limits.\n| **Note:** Quotas and limits are subject to elimination, reduction, or change at any time, without notice.\n\nUpdate policy\n-------------\n\nMerchant API enforces the following policies in terms of updates:\n\n- You can only update your products up to twice per day.\n- You can only update your sub-accounts once per day.\n\nQuota-related changes between Merchant API and Content API for Shopping\n-----------------------------------------------------------------------\n\n- Quota will be counted per resource, not per method. This means some services are now linked.\n- The absence of custom batching doesn't affect quota calculation. For example, a batch request containing 500 insert requests will be charged as 500 individual insert method requests.\n- Quota automation for accounts and products remains in place.\n- To determine your current quota usage and limits, including automation and overrides, use the [Quota.list method](/merchant/api/reference/rest/quota_v1/accounts.quotas/list).\n\n| **Note:** For the `accounts.list` method, quota and limits usage are charged for each user, and not for the Merchant Center ID or the advanced account ID. To list several sub-accounts, you should use the `accounts.listSubaccounts` method, which is more suitable for advanced accounts use case.\n\nMethod call quotas\n------------------\n\nMerchant API automatically adjusts call quotas for your\n[`products`](/merchant/api/guides/products/overview) and\n[`accounts`](/merchant/api/guides/accounts/overview) based on your usage.\n\nHere's how we track your quota usage:\n\n- Quotas are per-method. For example, the `get` method has a separate quota from the `update` method.\n- Each request counts once, regardless of its type. For example, we count a `list` request of 250 items once, not as 250 `get` requests.\n- Quota is charged based on the user who makes the API request. If the user is a direct member of an advanced account, the quota will be charged at the level of the advanced account.\n- Quotas apply to the Comparison Shopping Services (CSS) group, CSS, account, or [sub-accounts](/merchant/api/guides/accounts/sub-accounts) against which you authenticate when you make the call. For example, if you authenticate as an [advanced account](https://support.google.com/merchants/answer/188487), calls count against your advanced account's quota, but if you authenticate as one of your sub-accounts, calls count against the sub-account's quota.\n\n\u003cbr /\u003e\n\nThe diagram shows the hierarchy of CSS groups, CSS, accounts, and sub-accounts.\n\n### Check your quotas\n\nTo check the current quota and usage for an account, call\n[`quotas.list`](/merchant/api/reference/rest/quota_v1/accounts.quotas/list)\nwith the `name` of the account.\n\nAutomatic quota only applies to the `products` and `accounts` services. If you\nneed an increased quota for any other service, you're hitting your daily quota\nfor the `products` or `accounts` services, or you need a temporary increase for\nthe `accounts` or products `services`, [contact\nus](/merchant/api/support/get-help) with the following information:\n\n- Your Merchant Center ID\n- The methods you've reached your quota limits on\n- An estimate of the number of calls per day you need for those methods\n- The reason you need a quota increase\n- Whether it's a temporary or permanent increase\n\nWe recommend checking your quotas periodically to ensure you have sufficient\nquota for your implementation, or how your quota is adjusted automatically.\n\n### Errors\n\nIf you exceed the quotas, you receive the following errors:\n\n- Per minute: `quota/request_rate_too_high`\n- Per day: `quota/daily_limit_exceeded`\n\nTo view your quotas and usage, and request a per-day or per-minute quota\nincrease, see [Check your quotas](#check_your_quotas).\n\nThe following errors can't be resolved by automatic quota increases, and require\nyou to [request additional quota of items, feeds or\nsub-accounts](//support.google.com/merchants/contact/additional_items):\n\n- `too_many_items: Merchant quota exceeded`\n- `too_many_subaccounts: Maximum number of sub-accounts reached`\n\nResource representation limits\n------------------------------\n\nThe following limits describe notable restrictions for certain string values and\narray fields within the resource representations used in the Merchant API. These\nlimits are the same for both the Merchant API and their corresponding feature in\nthe Merchant Center.\n\nNote that this list of limits may not be complete. We won't extend these limits.\n\n| Resource | Field | Limit |\n|------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------|\n| [`shippingsettings`](/merchant/api/reference/rest/accounts_v1/accounts.shippingSettings) | Shipping services per country (`services`). Shipping groups per shipping service (`rateGroups`). Labels per shipping group (`applicableShippingLabels`). Subtables per shipping group (`subtables`). Number of rows or columns in a single [rate table](#note2). Length of shipping labels. | 20 20 30 100 150 100 |\n\nThe number of rows or columns in a rate table affects the following array fields:\n\n- Array fields within `rowHeaders` or `columnHeaders`:\n - `prices[]`\n - `weights[]`\n - `numberOfItems[]`\n - `postalCodeGroupNames[]`\n - `locations[]`\n - `rows[]`\n - `cells[]`"]]
