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 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 subaccount al massimo due volte al giorno.
• Puoi chiamare i metodi dell'origine dati per i tuoi subaccount, ad esempio list o create, al massimo due volte al giorno per ogni subaccount.

Quote di chiamate al metodo

L'API Merchant regola automaticamente le quote di chiamate per:

• products e accounts in base al tuo utilizzo.
• datasources per gli account avanzati in base al numero di subaccount.

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.
• Per il servizio datasources, la scalabilità automatica della quota si applica solo agli account avanzati in base al numero di subaccount. Le quote per gli account autonomi e i subaccount sono statiche e gli aumenti non sono generalmente supportati. Per controllare i limiti di quota di datasource, utilizza i accounts.limits metodi.
• 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 rispetto alla quota dell'account avanzato, ma se esegui l'autenticazione come uno dei tuoi subaccount, le chiamate vengono conteggiate rispetto 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 metodo di inserimento.
• L'automazione delle quote per account e prodotti rimane in vigore.
• Per determinare l'utilizzo e i limiti delle quote attuali, inclusi l'automazione e le sostituzioni, utilizza il metodo Quota.list.

Controlla le quote di chiamate

Per controllare le quote di chiamate e l'utilizzo attuali per un account, chiama quotas.list con il name dell'account.

La quota automatica si applica ai servizi products, accounts e datasources.

• Per le risorse con quote automatiche (products, accounts e datasources per gli account avanzati): puoi richiedere solo un aumento temporaneo per scenari speciali come il lancio in un nuovo mercato o durante le stagioni di shopping con traffico elevato. Non accettiamo aumenti permanenti delle quote per questo tipo di risorse.
• Per tutte le altre risorse senza quote automatiche: puoi richiedere aumenti delle quote in base alle esigenze.

Utilizza il problema Quota increase request del modulo Contatta l'assistenza e compilalo 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 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 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 degli annunci 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[]