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 que deux fois par jour.
• Vous ne pouvez appeler les méthodes de source de données pour vos sous-comptes, telles que list ou create, que deux fois par sous-compte et par jour.

Quotas concernant les appels de méthode

Merchant API ajuste automatiquement les quotas d'appels pour :

• products et accounts en fonction de votre utilisation.
• datasources pour les comptes avancés en fonction du nombre de leurs sous-comptes.

Voici comment nous suivons votre utilisation des quotas :

• Les quotas sont indiqués pour chaque méthode. Par exemple, la méthode get dispose d'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 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é.
• Pour le service datasources, la mise à l'échelle automatique des quotas ne s'applique qu'aux comptes avancés en fonction du nombre de leurs sous-comptes. Les quotas pour les comptes individuels et les sous-comptes sont statiques, et les augmentations ne sont généralement pas acceptées. Pour vérifier les limites de quota datasource, utilisez les accounts.limits méthodes.
• Les quotas s'appliquent au groupe de services de comparateur de prix (CSS), au CSS, au compte ou aux sous-comptes 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 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 s'applique aux services products, accounts et datasources.

• Pour les ressources avec des quotas automatiques (products, accounts et datasources pour les comptes avancés) : vous ne pouvez demander qu'une augmentation temporaire pour des scénarios spéciaux, comme le lancement sur un nouveau marché ou pendant les périodes de forte activité commerciale. Nous n'acceptons pas les augmentations permanentes de quota pour ce type de ressources.
• Pour toutes les autres ressources sans quotas automatiques : vous pouvez demander des augmentations de quota selon vos besoins.

Utilisez le problème Quota increase request du formulaire Contacter l'assistance et remplissez-le avec 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'une augmentation de quota
• Si l'augmentation est 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 d'annonces dans l'EEE d'un compte, vous devez spécifier l'ID du compte et l'ID de limite dans votre appel à accounts.limits.get. L'ID de limite est une combinaison du type de limite et du champ d'application. 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 pour 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 peut-être 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[]