Quote e limiti

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

Aggiorna policy

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

• Puoi aggiornare i tuoi prodotti al massimo due volte al giorno. Per rispettare la quota al minuto, devi distribuire uniformemente le chiamate giornaliere durante la giornata.
• Puoi aggiornare i tuoi subaccount al massimo due volte al giorno.

Quote di chiamate ai metodi

L'API Merchant regola automaticamente le quote di chiamate 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 separata dal metodo update.
• Ogni richiesta viene conteggiata una volta, indipendentemente dal tipo. Ad esempio, conteggiamo una richiesta list di 250 articoli una 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 per i quali esegui l'autenticazione quando effettui la chiamata. Ad esempio, se esegui l'autenticazione come un account avanzato, le chiamate vengono conteggiate in base alla quota del tuo 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 rispetto all'API Content for Shopping

Se hai utilizzato l'API Content for Shopping, tieni presente le seguenti modifiche alla quota di chiamate ai metodi 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 singole richieste di inserimento del metodo.
• L'automazione delle quote per account e prodotti rimane attiva.
• Per determinare l'utilizzo e i limiti delle quote attuali, inclusi l'automazione e le sostituzioni, utilizza il metodo Quota.list.

Verifica le quote di chiamate

Per verificare le quote di chiamate e l'utilizzo attuali di un account, chiama quotas.list con il 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, stai raggiungendo la quota giornaliera per i servizi products o accounts oppure hai bisogno di un aumento temporaneo per i servizi accounts o products services, contattaci con 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 al giorno di cui hai bisogno 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 la tua implementazione o per verificare come viene regolata automaticamente la quota.

Errori

Se superi la quota, riceverai i seguenti errori:

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

Per visualizzare la quota e l'utilizzo e richiedere un aumento della quota giornaliera o al minuto consulta Controlla 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 controllare i limiti delle entità a livello di account. Puoi utilizzare questi metodi per controllare 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 di limite e dell'ambito. Ad esempio, products~ADS_EEA per i prodotti che targetizzano gli annunci nel SEE e products~ADS_NON_EEA per i prodotti che targetizzano 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[]