Importante: l'API Content for Shopping verrà ritirata il 18 agosto 2026.

Scopri l'API Merchant , il successore ufficiale dell'API Content for Shopping.

Ricevi le ultime novità su nuove funzionalità, correzioni di bug e aggiornamenti dell'API Merchant.

Inizia a utilizzare l'API Merchant e accedi a dati, approfondimenti e funzionalità uniche su larga scala.

Hai bisogno di altro tempo per eseguire la migrazione? Richiedi un'estensione utilizzando il modulo di richiesta di estensione dell'API Content for Shopping.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Errori comuni

Ecco gli errori più comuni:

notFound: elemento non trovato.
not_inserted: impossibile inserire l'elemento.
[link] validation/invalid_value for <destinations>: Gli URL non appartengono al tuo sito web.
quota/too_many_items: Quota del commerciante superata.

Di seguito è riportato un elenco degli errori in ordine alfabetico.

auth/account_access_denied

`User cannot access account <account_number>`
Riepilogo	È stata emessa una richiesta che ha come target un account a cui l'utente autenticato non ha accesso.
Cause comuni	Errore nell'ID commerciante target o mancata registrazione dell'utente in Merchant Center.
Suggerimenti per la gestione consigliati	Verifica di scegliere come target l'account corretto o registrati come utente dell'account in Merchant Center (Impostazioni > Utenti).
Suggerimenti per la prevenzione	ND
`User is not an administrator of account <account_number>`
Riepilogo	Ha inviato una richiesta di modifica di un account per il quale l'utente autenticato non dispone dei diritti amministrativi.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Imposta i diritti amministrativi per l'utente autenticato.
Suggerimenti per la prevenzione	ND

conflitto

`[productId] Product ID <product id> is already modified by another entry in the same request for merchant <merchant> and store code <store code>`
Riepilogo	Sono state tentate più operazioni in conflitto contemporaneamente.
Cause comuni	Una singola richiesta batch contiene più operazioni in conflitto per lo stesso prodotto oppure più operazioni in conflitto per lo stesso prodotto sono state inviate all'API Content contemporaneamente.
Suggerimenti per la gestione consigliati	Consulta i suggerimenti per la prevenzione.
Suggerimenti per la prevenzione	Contenere tutte le modifiche per un determinato prodotto in una singola operazione in un insieme batch di richieste. Cerca di evitare più chiamate simultanee all'API Content per lo stesso commerciante e codice negozio oppure assicurati che queste chiamate non contengano prodotti sovrapposti.

internalError

`Internal error`
Riepilogo	Si è verificato un problema con il backend di Google.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Riprova a inviare la richiesta. Contattaci se l'operazione non va a buon fine.
Suggerimenti per la prevenzione	ND

non valido

`Invalid channel: '<channel>'`
Riepilogo	Canale non valido fornito come parte di un ID prodotto. Ad esempio: `not_a_channel:en:US:sku123`.
Cause comuni	ND
Suggerimenti per la gestione consigliati	ND
Suggerimenti per la prevenzione	Assicurati che l'ID prodotto sia nel formato `channel:languageCode:countryCode:offerId`, ad esempio: `online:en:US:sku123`. Per saperne di più, consulta la documentazione di riferimento per `Products.insert`.
`[countrycode] Invalid country code: '<country_code>'`
Riepilogo	Codice paese non valido fornito come parte di un ID prodotto. Ad esempio: `online:en:not_a_country_code:sku123`.
Cause comuni	ND
Suggerimenti per la gestione consigliati	ND
Suggerimenti per la prevenzione	Assicurati che l'ID prodotto sia nel formato `channel:languageCode:countryCode:offerId` e che il codice paese sia un codice paese ISO 3166 valido.
`[item id] Invalid item id: '<id>'`
Riepilogo	ID articolo non valido, ad es. `sku123` invece di `online:en:US:sku123`.
Cause comuni	Specificare un ID offerta anziché un ID prodotto in una richiesta `GET` o `DELETE`.
Suggerimenti per la gestione consigliati	ND
Suggerimenti per la prevenzione	Assicurati che l'ID prodotto sia nel formato `channel:languageCode:countryCode:offerId`.
`[name] The term '<term>' is not allowed`
Riepilogo	Il nome contiene una parola vietata.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Utilizza un nome consentito. Per saperne di più, consulta l'articolo del Centro assistenza sulle specifiche dei feed.
Suggerimenti per la prevenzione	ND
`[price.currency] Please use a currency that is supported in the target country`
Riepilogo	È stata specificata una valuta non disponibile nel paese target.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Assicurati che la valuta e il paese siano specificati correttamente. Per saperne di più, consulta la sezione su `price` nell'articolo del Centro assistenza sulle specifiche dei feed.
Suggerimenti per la prevenzione	ND
`[storeCode] storeCode must be 'online'`
Riepilogo	Hai tentato di aggiornare il prezzo e la disponibilità di un prodotto online tramite il feed di inventario, ma hai specificato un valore diverso da `online` come ID negozio nell'URL.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Modifica l'ID store in `online` nell'URL della richiesta.
Suggerimenti per la prevenzione	Assicurati di specificare `online` per i prodotti online e l'ID negozio per i prodotti locali in tutte le tue query di inventario.
`[<attribute>]`
Riepilogo	L'elemento specificato tra parentesi quadre non è valido.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Correggi la specifica dell'articolo problematico. Per saperne di più, consulta l'articolo del Centro assistenza sulle specifiche dei feed.
Suggerimenti per la prevenzione	ND

notFound

`Item not found`
Riepilogo	L'elemento che hai tentato di ottenere, aggiornare o eliminare non esiste.
Cause comuni	Tentativo di eliminazione di un prodotto che non esiste o mancata specifica dell'ID prodotto corretto nell'URL per l'eliminazione.
Suggerimenti per la gestione consigliati	Ottieni un elenco di prodotti utilizzando `Products.list` e tenta di ottenere, aggiornare o eliminare solo gli elementi visualizzati. Assicurati di specificare l'ID prodotto nel modulo `channel:languageCode:countryCode:offerId`, ad esempio: `online:ru:RU:277104-ekb` anziché l'ID offerta, che ha questo aspetto: `277104-ekb`.
Suggerimenti per la prevenzione	ND

not_inserted

`The item could not be inserted.`
Riepilogo	A causa di altri errori, il prodotto non è stato inserito perché sovrascriverebbe una voce valida esistente.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Controlla gli altri errori per la stessa chiamata e risolvili prima di tentare di reinserire le nuove informazioni sul prodotto.
Suggerimenti per la prevenzione	ND

quota

`too_many_items: Merchant quota exceeded`
Riepilogo	Sono stati caricati troppi articoli su Google Shopping.
Cause comuni	I prodotti che non superano la convalida possono comunque essere inseriti, se non sostituiscono un prodotto valido esistente. Valuta la possibilità di utilizzare il flag `includeInvalidInsertedItems` per `Productstatuses.list` per assicurarti che il tuo account non abbia un numero eccessivo di prodotti non validi.
Suggerimenti per la gestione consigliati	Controlla e rimuovi un numero eccessivo di prodotti non validi come indicato sopra. Inoltre, specifica le date di scadenza durante il caricamento dei prodotti. Quando viene raggiunta la data di scadenza, il prodotto viene eliminato automaticamente. Tieni presente che la data di scadenza predefinita e massima è 30 giorni dopo l'inserimento o l'aggiornamento del prodotto. Nota: la quota di articoli per un account multi-cliente viene verificata in base al numero totale di prodotti in tutti i subaccount. Se ricevi questo errore con un subaccount, assicurati che sia il subaccount sia l'account AMC dispongano di una quota di prodotti sufficiente. Se hai provato queste soluzioni e lo spazio per i nuovi prodotti nel tuo account Merchant Center è ancora insufficiente, puoi richiedere la possibilità di inviare più articoli nel tuo account.
Suggerimenti per la prevenzione	Consulta i suggerimenti per la gestione consigliati.
`too_many_subaccounts: Maximum number of subaccounts reached`
Riepilogo	Hai raggiunto il numero massimo di subaccount consentiti per il tuo account multicliente.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Elimina i subaccount obsoleti. Se tutti i tuoi account sono attivi, puoi richiedere la possibilità di creare altri subaccount nel tuo AMC.
Suggerimenti per la prevenzione	ND
`request_rate_too_high: Request rate too high. Please reduce your throughput`
Riepilogo	Le richieste vengono effettuate troppo rapidamente; riduci la frequenza delle richieste.
Cause comuni	Fai riferimento alle quote per minuto elencate nei limiti pubblicati. Se superi queste soglie, riceverai questo errore. A volte si verifica un picco di traffico che causa questo problema oppure il server si espande a un numero maggiore di thread.
Suggerimenti per la gestione consigliati	Riduci il numero totale di richieste inviate al minuto.
Suggerimenti per la prevenzione	Quando ricevi questo errore, utilizza strategie di backoff programmatico per ridurre la frequenza delle richieste a un livello sostenibile adeguato.
`daily_limit_exceeded: merchant quota exceeded`
Riepilogo	Stai effettuando un numero di richieste giornaliere superiore a quello consentito per il metodo di servizio specificato.
Cause comuni	Consulta le quote giornaliere elencate nei limiti pubblicati. Se superi queste soglie, riceverai questo errore.
Suggerimenti per la gestione consigliati	Riduci il numero totale di richieste inviate al giorno combinando più modifiche in un'unica richiesta quando possibile. Valuta la possibilità di raggruppare le modifiche ai prodotti in un periodo di tempo appropriato per evitare di modificare rapidamente un prodotto più volte. Per gli aggiornamenti degli articoli che possono essere rappresentati come microdati sul tuo sito web, valuta la possibilità di utilizzare questo approccio per limitare il numero di chiamate ai servizi `Products` o `Inventory`. Se hai ancora bisogno di più chiamate giornaliere a un determinato metodo, contattaci e comunicaci il tuo ID Merchant Center, i metodi per i quali stai raggiungendo i limiti di quota, una stima del numero di chiamate al giorno di cui avrai bisogno per questi metodi e il motivo. Collaboreremo con te per aumentare la tua quota.
Suggerimenti per la prevenzione	Consulta i suggerimenti per la gestione consigliati.
`too_many_failed_auths: Too many failed authentications.`
Riepilogo	Stai effettuando troppe richieste batch per account a cui non hai accesso.
Cause comuni	Effettuare richieste in batch per i subaccount eliminati o per i subaccount appena creati prima che siano disponibili.
Suggerimenti per la gestione consigliati	Evita di effettuare chiamate che interessano un subaccount eliminato.
Suggerimenti per la prevenzione	Consulta i suggerimenti per la gestione consigliati.
`request_too_large`
Riepilogo	Stai inviando troppi `entries` per richiesta batch oppure superi il limite di dimensioni della richiesta `custombatch`.
Cause comuni	Puoi includere un massimo di 10.000 `entries` per richiesta `custombatch` e il limite di dimensione del trasferimento compresso è di 32 MB.
Suggerimenti per la gestione consigliati	Dividi il batch in più batch che rientrano nei limiti, quindi riprova.
Suggerimenti per la prevenzione	Ti consigliamo di inviare non più di 1000 voci per batch.

di provisioning.

`[price.value] Required parameter: price.value`
Riepilogo	È stato specificato un prezzo senza valore. Ad esempio: `{ "currency": "USD" }` invece di `{ "value": 123, "currency": "USD" }`.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Assicurati che il parametro qui `price` sia ben formato. Ad esempio, `price` ha due campi obbligatori: `value` e `currency`.
Suggerimenti per la prevenzione	ND
`[product] INSERT request must specify product`
Riepilogo	Ha inviato una richiesta batch personalizzata all'API contenente una voce con `"method": "insert"` ma nessun prodotto.
Cause comuni	Dimenticanza di modificare il metodo in `get` o `delete`.
Suggerimenti per la gestione consigliati	Specifica un prodotto da inserire tramite il campo `product`.
Suggerimenti per la prevenzione	Assicurati che le voci batch con il metodo `insert` specifichino un prodotto e che le voci batch con il metodo `get` o `delete` specifichino un ID prodotto.
`[productId] DELETE request must specify productId`
Riepilogo	Hai inviato una richiesta batch personalizzata all'API contenente una voce con `"method": "delete"`, ma nessun ID prodotto.
Cause comuni	Dimenticanza di modificare il metodo in `insert`.
Suggerimenti per la gestione consigliati	Specifica un prodotto da eliminare tramite il campo `productID`.
Suggerimenti per la prevenzione	Assicurati che le voci batch con il metodo `insert` specifichino un prodotto e che le voci batch con il metodo `get` o `delete` specifichino un ID prodotto.

userRateLimitExceeded

`User Rate Limit Exceeded`
Riepilogo	Le richieste vengono effettuate troppo rapidamente; riduci la frequenza delle richieste.
Cause comuni	Consulta i limiti delle richieste HTTP elencati nei limiti pubblicati. Se superi queste soglie, riceverai questo errore. A volte si verifica un picco di traffico che causa questo problema oppure il server si espande a un numero maggiore di thread.
Suggerimenti per la gestione consigliati	Riduci il numero totale di richieste inviate al minuto. Il raggruppamento in batch di più chiamate di metodi allo stesso servizio in una singola richiesta `custombatch` ridurrà il numero di richieste HTTP effettuate.
Suggerimenti per la prevenzione	Quando ricevi questo errore, utilizza strategie di batching e di backoff programmatico per ridurre la frequenza delle richieste a un livello sostenibile adeguato.

convalida

`[adwords_redirect]`
Riepilogo	Hai inviato un prodotto il cui campo `adwords_redirect` non è un URL valido.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Assicurati che il valore del campo `adwords_redirect` sia un URL valido.
Suggerimenti per la prevenzione	ND
`[item] auth/frontend/not_claimed`
Riepilogo	L'URL del sito web del commerciante non è stato rivendicato in Merchant Center.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Rivendica l'URL in Merchant Center. La procedura dettagliata è disponibile nel Centro assistenza.
Suggerimenti per la prevenzione	ND
`[energy_efficiency_class] validation/feed`
Riepilogo	Sono stati specificati sia il prezzo unitario `energyEfficiencyClass` sia il prezzo unitario per lo stesso prodotto.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Specifica solo la classe energetica o il prezzo unitario, non entrambi.
Suggerimenti per la prevenzione	ND
`[item] internal`
Riepilogo	Un errore interno.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Riprova a inviare la richiesta. Contattaci se l'operazione non va a buon fine.
Suggerimenti per la prevenzione	ND
`[item_group_id] invalid_attribute`
Riepilogo	Hai inviato un articolo con sia `itemGroupId` sia molti valori per un attributo della variante (colore, taglia, motivo o materiale).
Cause comuni	Specificare più di una taglia per un prodotto specificando un ID gruppo di articoli.
Suggerimenti per la gestione consigliati	Invia un prodotto diverso per ogni valore di un determinato attributo di variante, ad esempio `size`.
Suggerimenti per la prevenzione	ND
`[additional_image_link] invalid_attribute`
Riepilogo	Sono stati inviati più di 10 link immagine aggiuntivi.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Limita il numero di link immagine aggiuntivi a 10.
Suggerimenti per la prevenzione	ND
`[<attribute>] invalid_character`
Riepilogo	Hai inviato un brand, una descrizione o un altro attributo come stringa che non viene analizzata utilizzando la codifica della richiesta specificata.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Controlla il messaggio per scoprire quale attributo causa il problema, quindi convalida la codifica del testo del valore corrispondente prima di inviare nuovamente. L'API accetta solo caratteri UTF-8 validi.
Suggerimenti per la prevenzione	ND
`[<attribute>] invalid_value`
Riepilogo	Hai inviato un colore, una descrizione o un altro attributo non valido.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Assicurati che tutti gli attributi rispettino le specifiche del feed. Per maggiori informazioni, consulta l'articolo del Centro assistenza sulle specifiche del feed. Per problemi relativi a GTIN o MPN, consulta l' articolo del Centro assistenza sui codici identificativi di prodotto.
Suggerimenti per la prevenzione	ND
`[<attribute>] missing_recommended`/`missing_required`
Riepilogo	Hai inviato un prodotto senza un attributo obbligatorio/consigliato.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Assicurati di includere tutti gli attributi consigliati / obbligatori per il tuo prodotto. Per saperne di più, consulta l'articolo del Centro assistenza sulle specifiche dei feed.
Suggerimenti per la prevenzione	ND
`[link] validation/invalid_value for <destinations>: URLs do not belong to your website`
Riepilogo	Hai inviato un prodotto con un URL di base diverso dall'URL rivendicato dall'account Merchant Center.
Cause comuni	ND
Suggerimenti per la gestione consigliati	Assicurati che gli URL dei prodotti inviati corrispondano al sito web rivendicato da Merchant Center.
Suggerimenti per la prevenzione	ND