Quotas et limites

Content API for Shopping fixe des quotas et des limites strictes pour certaines fonctionnalités. Ils sont susceptibles d'être supprimés, réduits ou modifiés à tout moment et sans préavis.

Règles de quotas

En moyenne, ne mettez pas à jour vos produits plus de deux fois par jour et vos sous-comptes plus d'une fois par jour.

Quotas d'appels de méthode

Content API for Shopping ajuste automatiquement vos quotas products et accounts en fonction de votre utilisation. Votre utilisation de accounts est basée sur la limite de vos sous-comptes.

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.
  • Les méthodes patch sont comptabilisées dans vos quotas get et update.
  • Chaque appel de méthode figurant dans un appel custombatch est comptabilisé séparément dans le quota de cette méthode.
  • Les appels sont décomptés du quota du compte pour lequel vous vous authentifiez lorsque vous passez 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.

Vérifier les quotas

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

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.

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 :

  • Il s'agit de 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.

Erreurs

Si vous dépassez les quotas de Content API for Shopping, 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.

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 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 Content API. Ces limites sont les mêmes pour Content API et les fonctionnalités correspondantes dans Merchant Center. Cette liste est non exhaustive, et les limites ne peuvent pas être augmentées.

Ressource Champ Limite
shippingsettings

Nombre de services de livraison par pays (services)

Nombre de groupes de livraison par service de livraison (rateGroups)

Nombre d'étiquettes par groupe de livraison (applicableShippingLabels)

Nombre de sous-tableaux par groupe de livraison (subtables)

Nombre de lignes ou de colonnes dans un seul tableau de tarifs.

Longueur des étiquettes de livraison

20

20

30

100

150

100

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[]