Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les fonctionnalités de l'API Merchant sont soumises à des quotas et des limites stricts.
Règles relatives à la mise à jour
L'API Merchant applique les règles suivantes en termes de mises à jour:
Vous ne pouvez modifier vos produits qu'une fois par jour.
Vous ne pouvez modifier vos sous-comptes qu'une fois par jour.
Modifications liées aux quotas entre l'API Merchant et Content API for Shopping
Le quota sera comptabilisé par ressource, et non par méthode. Cela signifie que certains services sont désormais associés.
L'absence de traitement par lot personnalisé n'a aucune incidence sur le calcul des quotas. Par exemple, une requête par lot contenant 500 requêtes d'insertion sera facturée comme 500 requêtes de méthode d'insertion individuelles.
L'automatisation des quotas pour les comptes et les produits reste en place.
Pour déterminer votre utilisation et vos limites de quota actuelles, y compris l'automatisation et les forçages, utilisez la méthode Quota.list.
Quotas concernant les appels de méthode
L'API Merchant ajuste automatiquement les quotas d'appels pour vos products et accounts en fonction de votre utilisation.
Voici comment nous suivons votre utilisation des quotas:
Les quotas sont indiqués pour chaque méthode. Par exemple, la méthode get possède un quota distinct de celui de la méthode update.
Chaque requête est comptabilisée une seule fois, quel que soit son type. Par exemple, nous comptabilisons une requête list de 250 éléments une seule fois, et non 250 requêtes get.
Le quota est facturé en fonction de l'utilisateur qui envoie la requête API. Si l'utilisateur est membre direct d'un compte avancé, le quota sera facturé au niveau du compte avancé.
Les quotas s'appliquent au groupe, au CSS, au compte ou aux sous-comptes contre lesquels vous vous authentifiez lorsque vous effectuez l'appel. Par exemple, si vous vous authentifiez en tant que compte avancé, les appels sont décomptés du quota de votre compte avancé. En revanche, si vous vous authentifiez en tant qu'un de vos sous-comptes, les appels sont décomptés du quota du sous-compte.
Le diagramme montre la hiérarchie des groupes CSS, des CSS, des comptes et des sous-comptes.
Vérifier les quotas
Pour vérifier le quota et l'utilisation actuels d'un compte, appelez quotas.list avec l'name du compte.
Le quota automatique ne s'applique qu'aux services products et accounts. Si vous avez besoin d'augmenter le quota pour un autre service, si vous atteignez votre quota quotidien pour les services products ou accounts, ou si vous avez besoin d'une augmentation temporaire pour les services accounts ou les produits services, contactez-nous en indiquant les informations suivantes:
Votre ID Merchant Center
Les méthodes pour lesquelles vous avez atteint la limite de quota
Une estimation du nombre d'appels par jour dont vous avez besoin pour ces méthodes
Motif pour lequel vous avez besoin d'une augmentation de quota
S'il s'agit d'une augmentation temporaire ou permanente
Nous vous recommandons de vérifier régulièrement vos quotas pour vous assurer que vous disposez de suffisamment de quotas pour votre implémentation ou de la façon dont votre quota est ajusté automatiquement.
Erreurs
Si vous dépassez les quotas, les erreurs suivantes s'affichent:
Par minute: quota/request_rate_too_high
Par jour: quota/daily_limit_exceeded
Pour afficher vos quotas et votre utilisation, et demander une augmentation de quota par jour ou par minute, consultez Vérifier vos quotas.
too_many_subaccounts: Maximum number of sub-accounts reached
Limites concernant les représentations de ressources
Les limites suivantes décrivent les restrictions importantes appliquées à certains champs de tableau et valeurs de chaîne dans les représentations de ressources utilisées dans Merchant API. Ces limites sont les mêmes pour Merchant API et les fonctionnalités correspondantes dans Merchant Center.
Notez que cette liste de limites n'est pas exhaustive. Nous ne prolongerons pas ces limites.
Le nombre de lignes ou de colonnes dans un tableau de tarifs affecte les champs de tableau suivants:
Champs de tableau inclus dans rowHeaders ou columnHeaders :
prices[]
weights[]
numberOfItems[]
postalCodeGroupNames[]
locations[]
rows[]
cells[]
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/08 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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[]`"]]
