Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Os recursos da API Merchant têm cotas e limites rígidos.
Atualizar política
A API Merchant aplica as seguintes políticas em termos de atualizações:
Só é possível atualizar os produtos duas vezes por dia.
Só é possível atualizar as subcontas uma vez por dia.
Mudanças relacionadas à cota entre a API Merchant e a API Content for Shopping
A cota será contada por recurso, não por método. Isso significa que alguns serviços
agora estão vinculados.
A ausência de lotes personalizados não afeta o cálculo da cota. Por exemplo,
uma solicitação em lote contendo 500 solicitações de inserção será cobrada como 500
solicitações individuais de método de inserção.
A automação de cotas para contas e produtos continua em vigor.
Para determinar o uso e os limites atuais da cota, incluindo a automação e as substituições, use o método Quota.list.
Cotas de chamadas de método
A API Merchant ajusta automaticamente as cotas de chamadas para
products e
accounts com base no seu uso.
Confira como monitoramos o uso da cota:
As cotas são por método. Por exemplo, o método get tem uma cota separada do método update.
Cada solicitação é contada uma vez, independentemente do tipo. Por exemplo, contamos uma
solicitação list de 250 itens uma vez, e não como 250 solicitações get.
A cobrança da cota é feita com base no usuário que faz a solicitação da API. Se o usuário for
um membro direto de uma conta avançada, a cota será cobrada no
nível da conta avançada.
As cotas se aplicam ao grupo de serviços de comparação de preços (CSS), ao CSS, à conta
ou às subcontas em que você
se autentica ao fazer a chamada. Por exemplo, se você fizer a autenticação como
uma conta avançada,
as chamadas serão contabilizadas na cota da sua conta avançada. No entanto, se você fizer a autenticação
como uma das suas subcontas, as chamadas serão contabilizadas na cota da subconta.
O diagrama mostra a hierarquia de grupos do CSS, CSS, contas e subcontas.
Verificar suas cotas
Para verificar a cota e o uso atuais de uma conta, chame
quotas.list
com o name da conta.
A cota automática se aplica apenas aos serviços products e accounts. Se você
precisar de um aumento de cota para qualquer outro serviço, se estiver atingindo sua cota diária
para os serviços products ou accounts ou se precisar de um aumento temporário para
o accounts ou os produtos services, entre em contato
com a gente com as seguintes informações:
Seu ID do Merchant Center
Os métodos em que você atingiu os limites de cota
Uma estimativa do número de chamadas por dia que você precisa para esses métodos
O motivo do aumento de cota
Se é um aumento temporário ou permanente
Recomendamos verificar suas cotas periodicamente para garantir que você tenha cota suficiente para a implementação ou como ela é ajustada automaticamente.
Erros
Se você exceder as cotas, receberá os seguintes erros:
Por minuto: quota/request_rate_too_high
Por dia: quota/daily_limit_exceeded
Para conferir suas cotas e o uso e solicitar um aumento de cota por dia ou minuto, consulte Verificar suas cotas.
too_many_subaccounts: Maximum number of sub-accounts reached
Limites de representação de recursos
Os limites a seguir descrevem restrições importantes para determinados valores de string e
campos de matriz nas representações de recursos usadas na API Merchant. Esses limites são os mesmos para a API Merchant e o recurso correspondente no Merchant Center.
Essa lista de limites pode não estar completa. Não vamos estender esses limites.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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[]`"]]
