Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Le funzionalità dell'API Merchant prevedono quote e limiti rigorosi.
Aggiorna criterio
L'API Merchant applica le seguenti norme in termini di aggiornamenti:
Puoi aggiornare i prodotti solo fino a due volte al giorno.
Puoi aggiornare i subaccount solo una volta al giorno.
Modifiche relative alle quote tra l'API Merchant e l'API Content for Shopping
La quota verrà conteggiata per risorsa, non per metodo. Ciò significa che alcuni servizi
sono ora collegati.
L'assenza di raggruppamenti personalizzati non influisce sul calcolo della quota. Ad esempio,
una richiesta batch contenente 500 richieste di inserzione verrà addebitata come 500
richieste di metodi di inserimento individuali.
L'automazione delle quote per account e prodotti rimane in vigore.
Per determinare l'utilizzo e i limiti attuali delle quote, incluse automazioni e override, utilizza il metodo Quota.list.
Quote di chiamata ai metodi
L'API Merchant regola automaticamente le quote di chiamata per products e accounts in base al tuo utilizzo.
Ecco come monitoriamo l'utilizzo della quota:
Le quote sono per metodo. Ad esempio, il metodo get ha una quota distinta rispetto al metodo update.
Ogni richiesta viene conteggiata una volta, indipendentemente dal tipo. Ad esempio, conteggiamo una richiestalist di 250 articoli una sola volta, non come 250 richiesteget.
La quota viene addebitata in base all'utente che effettua la richiesta API. Se l'utente è un membro diretto di un account avanzato, la quota verrà addebitata a livello di account avanzato.
Le quote si applicano al gruppo, al CSS, all'account o ai subaccount del servizio di shopping comparativo (CSS) per i quali effettui l'autenticazione quando effettui la chiamata. Ad esempio, se esegui l'autenticazione come account avanzato, le chiamate vengono conteggiate ai fini della quota dell'account avanzato, ma se esegui l'autenticazione come uno dei tuoi subaccount, le chiamate vengono conteggiate ai fini della quota del subaccount.
Il diagramma mostra la gerarchia dei gruppi di CSS, dei CSS, degli account e dei subaccount.
Verifica le tue quote
Per controllare la quota e l'utilizzo attuali di un account, chiama
quotas.list
con il name dell'account.
La quota automatica si applica solo ai servizi products e accounts. Se
hai bisogno di aumentare la quota per qualsiasi altro servizio, hai raggiunto la quota giornaliera
per i servizi products o accounts o hai bisogno di un aumento temporaneo per
accounts o i prodotti services, contattaci fornendo le seguenti informazioni:
Il tuo ID Merchant Center
I metodi per i quali hai raggiunto i limiti di quota
Una stima del numero di chiamate giornaliere necessarie per questi metodi
Il motivo per cui hai bisogno di un aumento della quota
Se si tratta di un aumento temporaneo o permanente
Ti consigliamo di controllare periodicamente le quote per assicurarti di averne una sufficiente per l'implementazione o di come la quota viene regolata automaticamente.
Errori
Se superi le quote, ricevi i seguenti errori:
Al minuto: quota/request_rate_too_high
Al giorno: quota/daily_limit_exceeded
Per visualizzare le quote e l'utilizzo e richiedere un aumento della quota giornaliera o per minuto, consulta Controllare le quote.
too_many_subaccounts: Maximum number of sub-accounts reached
Limiti di rappresentazione delle risorse
I seguenti limiti descrivono limitazioni significative per determinati valori delle stringhe e
campi di array all'interno delle rappresentazioni delle risorse utilizzate nell'API Merchant. Questi limiti sono gli stessi sia per l'API Merchant sia per la funzionalità corrispondente in Merchant Center.
Tieni presente che questo elenco di limiti potrebbe non essere completo. Non estenderemo questi limiti.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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[]`"]]
