Quote e limiti

Il tuo account commerciante e il tuo utilizzo dell'API Merchant sono soggetti a quote e limiti.

Aggiorna criterio

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

• Puoi aggiornare i tuoi prodotti al massimo due volte al giorno.
• Puoi aggiornare i tuoi account secondari solo una volta al giorno.

Quote per le chiamate ai metodi

L'API Merchant regola automaticamente le quote di chiamate per i tuoi 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 separata rispetto al metodo update.
• Ogni richiesta viene conteggiata una volta, indipendentemente dal tipo. Ad esempio, conteggiamo una richiesta list di 250 elementi una sola volta, non come 250 richieste get.
• La quota viene addebitata in base all'utente che effettua la richiesta API. Se l'utente è un membro diretto di un account avanzato, la quota verrà addebitata a livello di account avanzato.
• Le quote si applicano al gruppo di servizi di shopping comparativo (CSS), al CSS, all'account o ai subaccount rispetto ai quali esegui l'autenticazione quando effettui la chiamata. Ad esempio, se esegui l'autenticazione come account avanzato, le chiamate vengono conteggiate in base alla quota dell'account avanzato, ma se esegui l'autenticazione come uno dei tuoi subaccount, le chiamate vengono conteggiate in base alla quota del subaccount.

Il diagramma mostra la gerarchia di gruppi di CSS, CSS, account e subaccount.

Modifiche alla quota di chiamate ai metodi dell'API Content for Shopping

Se hai utilizzato l'API Content for Shopping, tieni presente le seguenti modifiche alla quota di chiamate al metodo nell'API Merchant:

• L'assenza di batch personalizzati non influisce sul calcolo della quota. Ad esempio, una richiesta batch contenente 500 richieste di inserimento viene addebitata come 500 richieste di metodo di inserimento individuali.
• L'automazione delle quote per account e prodotti rimane in vigore.
• Per determinare l'utilizzo e i limiti della quota attuali, inclusi automazione e override, utilizza il metodo Quota.list.

Controllare le quote di chiamate

Per controllare la quota e l'utilizzo attuali delle chiamate per 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 una quota maggiore per qualsiasi altro servizio, se hai raggiunto la quota giornaliera per i servizi products o accounts oppure se hai bisogno di un aumento temporaneo per i prodotti accounts o services, contattaci fornendo le seguenti informazioni:

• Il tuo ID Merchant Center
• I metodi per cui hai raggiunto i limiti di quota
• Una stima del numero di chiamate al giorno 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 avere una quota sufficiente per l'implementazione o per sapere come viene aggiustata 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 al minuto, consulta Controllare le quote di chiamate.

I seguenti errori non possono essere risolti con aumenti automatici della quota 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 dell'account

I metodi accounts.limits.get e accounts.limits.list consentono di verificare i limiti per le entità a livello di account. Puoi utilizzare questi metodi per verificare i limiti dei prodotti.

Per recuperare un limite di prodotto specifico, ad esempio per ottenere la quota SEE di Google Ads di un account, devi specificare l'ID account e l'ID limite nella chiamata a accounts.limits.get. L'ID limite è una combinazione del tipo e dell'ambito del limite. Ad esempio, products~ADS_EEA per i prodotti che hanno come target gli annunci nel SEE e products~ADS_NON_EEA per i prodotti che hanno come target gli annunci al di fuori del SEE.

Ecco una richiesta di esempio per ottenere il limite products~ADS_EEA per un determinato account:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits/products~ADS_EEA

Per scoprire gli ID limite disponibili per il tuo account, utilizza accounts.limits.list con un filtro per type="products":

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits?filter=type%3D%22products%22

Per ulteriori informazioni sulle quote dei prodotti, consulta Informazioni sulle quote in Google Merchant Center.

Limiti di rappresentazione delle risorse

I seguenti limiti descrivono limitazioni significative per determinati valori delle stringhe 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.

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

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