Quote e limiti

Le funzionalità dell'API Merchant prevedono quote e limiti rigorosi.

Aggiorna criterio

L'API Merchant applica le seguenti norme in termini di aggiornamenti:

  • Puoi aggiornare i prodotti solo fino a due volte al giorno.
  • Puoi aggiornare i subaccount solo una volta al giorno.

Quote di chiamata ai metodi

L'API Merchant regola automaticamente le quote di chiamata per products e accounts in base al tuo utilizzo.

Ecco come monitoriamo l'utilizzo della quota:

  • Le quote sono per metodo. Ad esempio, il metodo get ha una quota distinta rispetto al metodo update.
  • Ogni richiesta viene conteggiata una volta, indipendentemente dal tipo. Ad esempio, conteggiamo una richiestalist di 250 articoli una sola volta, non come 250 richiesteget.
  • Le quote si applicano al gruppo, al CSS, all'account o ai subaccount del servizio di shopping comparativo (CSS) per i quali effettui l'autenticazione quando effettui la chiamata. Ad esempio, se esegui l'autenticazione come account avanzato, le chiamate vengono conteggiate ai fini della quota dell'account avanzato, ma se esegui l'autenticazione come uno dei tuoi subaccount, le chiamate vengono conteggiate ai fini della quota del subaccount.

Il diagramma mostra la gerarchia dei gruppi di CSS, dei CSS, degli account e dei subaccount. L'immagine mostra che un gruppo di CSS è un livello di autenticazione generale, con la possibilità di singoli CSS al suo interno, account al loro interno e subaccount come livello più individuale.

Verifica le tue quote

Per controllare la quota e l'utilizzo correnti di un account, chiama quotas.list con l'name dell'account.

La quota automatica si applica solo ai servizi products e accounts. Se hai bisogno di aumentare la quota per qualsiasi altro servizio, hai raggiunto la quota giornaliera per i servizi products o accounts o hai bisogno di un aumento temporaneo per accounts o i prodotti services, contattaci fornendo le seguenti informazioni:

  • Il tuo ID Merchant Center
  • I metodi per i quali hai raggiunto i limiti di quota
  • Una stima del numero di chiamate giornaliere necessarie per questi metodi
  • Il motivo per cui hai bisogno di un aumento della quota
  • Se si tratta di un aumento temporaneo o permanente

Ti consigliamo di controllare periodicamente le quote per assicurarti di averne una sufficiente per l'implementazione o di come viene modificata automaticamente.

Errori

Se superi le quote, ricevi i seguenti errori:

  • Al minuto: quota/request_rate_too_high
  • Al giorno: quota/daily_limit_exceeded

Per visualizzare le quote e l'utilizzo e richiedere un aumento della quota giornaliera o per minuto, consulta Controllare le quote.

I seguenti errori non possono essere risolti con gli aumenti automatici delle quote e richiedono di richiedere una quota aggiuntiva di articoli, feed o subaccount:

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

Limiti di rappresentazione delle risorse

I seguenti limiti descrivono limitazioni significative per determinati valori di stringa e campi di array all'interno delle rappresentazioni delle risorse utilizzate nell'API Merchant. Questi limiti sono gli stessi sia per l'API Merchant sia per la funzionalità corrispondente in Merchant Center.

Tieni presente che questo elenco di limiti potrebbe non essere completo. Non estenderemo questi limiti.

Risorsa Campo Limite
shippingsettings

Servizi di spedizione per paese (services).

Gruppi di spedizione per servizio di spedizione (rateGroups).

Etichette per gruppo di spedizione (applicableShippingLabels).

Sottotabelle per gruppo di spedizione (subtables).

Numero di righe o colonne in una singola tabella delle tariffe.

Lunghezza delle etichette di spedizione.

20

20

30

100

150

100

Il numero di righe o colonne in una tabella delle tariffe influisce sui seguenti campi dell'array:

  • Campi array in rowHeaders o columnHeaders:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]