Quotas et limites

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

Règles relatives à la mise à jour

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

• Vous ne pouvez mettre à jour vos produits que deux fois par jour. Vous devez répartir uniformément les appels quotidiens tout au long de la journée pour respecter le quota par minute.
• Vous ne pouvez mettre à jour vos sous-comptes qu'une fois par jour.

Quotas concernant les appels de méthode

Merchant API ajuste automatiquement les quotas d'appels pour vos products et accounts en fonction de votre utilisation.

Voici comment nous effectuons le suivi de 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 fois, quel que soit son type. Par exemple, nous comptabilisons une requête list de 250 éléments une 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 un membre direct d'un compte avancé, le quota sera facturé au niveau du compte avancé.
• Les quotas s'appliquent au groupe de services de comparateur de prix (CSS), au CSS, au compte ou aux sous-comptes pour lesquels vous vous authentifiez lorsque vous effectuez l'appel. Par exemple, si vous vous authentifiez en tant que compte avancé, les appels sont comptabilisés dans le quota de votre compte avancé. Toutefois, si vous vous authentifiez en tant que l'un de vos sous-comptes, les appels sont comptabilisés dans le quota du sous-compte.

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

Modifications du quota d'appels de méthode par rapport à Content API for Shopping

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

• L'absence de traitement par lot personnalisé n'affecte pas 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 les quotas 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 services accounts ou products 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 le quota, les erreurs suivantes s'affichent :

• Par minute : quota/request_rate_too_high
• Par jour : quota/daily_limit_exceeded

Pour afficher votre quota 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 EEE d'un compte, vous devez spécifier l'ID de compte et l'ID de limite dans votre appel à accounts.limits.get. L'ID de limite est une combinaison du type de limite et de la portée. Par exemple, products~ADS_EEA pour les produits ciblant des annonces dans l'EEE et products~ADS_NON_EEA pour les produits ciblant des 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 limite 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 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 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[]