Quotas et limites

Votre compte Merchant et votre utilisation de l'API Merchant sont soumis à des quotas et des limites.

Règles relatives à la mise à jour

L'API Merchant applique les règles suivantes en termes de mises à jour :

• Vous ne pouvez mettre à jour vos produits que deux fois par jour.
• Vous ne pouvez mettre à jour vos sous-comptes qu'une fois par jour.

Quotas d'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 de quotas :

• Les quotas sont définis par méthode. Par exemple, la méthode get possède un quota distinct de celui de la méthode update.
• Chaque demande est comptabilisée une seule fois, quel que soit son type. Par exemple, une requête list de 250 éléments est comptabilisée une seule fois, et non comme 250 requêtes get.
• Le quota est facturé en fonction de l'utilisateur qui effectue 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 compte ou aux sous-comptes des services de comparateur de prix (CSS) auprès desquels 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 que l'un de vos sous-comptes, les appels sont décomptés du quota du sous-compte.

Le schéma montre la hiérarchie des groupes CSS, des CSS, des comptes et des sous-comptes.

Modifications apportées aux quotas d'appels de méthode dans Content API for Shopping

Si vous avez utilisé Content API for Shopping, notez les modifications suivantes apportées au quota d'appels de méthode dans l'API Merchant :

• L'absence de traitement par lot personnalisé n'a pas d'incidence sur le calcul du quota. Par exemple, une requête par lot contenant 500 requêtes d'insertion est 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 remplacements, utilisez la méthode Quota.list.

Vérifier vos quotas d'appels

Pour vérifier le quota d'appels et l'utilisation actuels d'un compte, appelez quotas.list avec le name du compte.

Le quota automatique ne s'applique qu'aux services products et accounts. Si vous avez besoin d'un quota plus élevé 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 produits accounts ou services, contactez-nous en nous fournissant les informations suivantes :

• Votre ID Merchant Center
• Les méthodes pour lesquelles vous avez atteint vos limites de quota
• Une estimation du nombre d'appels par jour dont vous avez besoin pour ces méthodes
• La raison pour laquelle vous avez besoin d'augmenter le 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 d'un quota suffisant pour votre implémentation ou pour savoir comment 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 consulter vos quotas et votre utilisation, et demander une augmentation de quota par jour ou par minute, consultez Vérifier vos quotas d'appels.

Les erreurs suivantes ne peuvent pas être résolues par des augmentations automatiques de quota. Vous devez demander un quota supplémentaire d'articles, de flux ou de sous-comptes :

• too_many_items: Merchant quota exceeded
• too_many_subaccounts: Maximum number of sub-accounts reached

Limites du compte

Les méthodes accounts.limits.get et accounts.limits.list vous permettent de vérifier les limites des entités au niveau du compte. Vous pouvez utiliser ces méthodes pour vérifier les limites de produits.

Pour récupérer une limite de produit spécifique (par exemple, pour obtenir le quota Ads pour l'EEE d'un compte), vous devez spécifier l'ID du compte et l'ID de la limite dans votre appel à accounts.limits.get. L'ID de limite est une combinaison du type et du champ d'application de la limite. Par exemple, products~ADS_EEA pour les produits ciblant les annonces dans l'EEE et products~ADS_NON_EEA pour les produits ciblant les annonces en dehors de l'EEE.

Voici un exemple de requête permettant d'obtenir la limite products~ADS_EEA pour un compte donné :

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits/products~ADS_EEA

Pour en savoir plus sur les ID de limites disponibles pour votre compte, utilisez accounts.limits.list avec un filtre pour type="products" :

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits?filter=type%3D%22products%22

Pour en savoir plus sur les quotas de produits, consultez Comprendre les quotas dans Google Merchant Center.

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 l'API Merchant. Ces limites sont les mêmes pour l'API Merchant et les fonctionnalités correspondantes dans Merchant Center.

Notez que cette liste de limites n'est pas exhaustive. Nous n'augmenterons 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[]