Quotas et limites

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.

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 comme 250 requêtes get.
  • 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. L'image montre qu'un groupe CSS est un niveau d'authentification global, avec la possibilité de CSS individuels, de comptes dans ces CSS et de sous-comptes comme niveau le plus individuel.

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.

Les erreurs suivantes ne peuvent pas être résolues par des augmentations automatiques de quota. Vous devez demander des quotas supplémentaires 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 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.

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