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.

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

Questa pagina è stata tradotta dall'API Cloud Translation.

Errori comuni

Ecco gli errori più comuni:

notFound: elemento non trovato.
not_inserted: non è stato possibile inserire l'articolo.
[link] validation/invalid_value for <destinations>: gli URL non appartengono al tuo sito web.
quota/too_many_items: quota commerciante superata.

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

auth/accesso_account_negato

`User cannot access account <account_number>`
Riepilogo	È stata inviata una richiesta indirizzata a un account a cui l'utente autenticato non ha accesso.
Cause comuni	Si è verificato un errore nell'ID commerciante di destinazione o hai dimenticato di registrare l'utente in Merchant Center.
Suggerimenti per la gestione consigliati	Verifica di aver scelto come target l'account corretto o registrati come utente dell'account in Merchant Center (Impostazioni > Utenti).
Suggerimenti per la prevenzione	N/A
`User is not an administrator of account <account_number>`
Riepilogo	È stata inviata una richiesta di modifica di un account per il quale l'utente autenticato non dispone di diritti di amministratore.
Cause comuni	N/A
Suggerimenti per la gestione consigliati	Imposta i diritti di amministratore per l'utente autenticato.
Suggerimenti per la prevenzione	N/A

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 eseguite 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 sullo stesso prodotto sono state inviate all'API Content contemporaneamente.
Suggerimenti per la gestione consigliati	Vedi suggerimenti di prevenzione.
Suggerimenti per la prevenzione	Contenere tutte le modifiche apportate a un determinato prodotto a una singola operazione in un insieme di richieste in batch. Cerca di evitare più chiamate simultanee all'API Content per lo stesso commerciante e lo stesso codice negozio oppure assicurati che queste chiamate non contengano prodotti che si sovrappongono.

internalError

`Internal error`
Riepilogo	Si è verificato un problema con il backend di Google.
Cause comuni	N/A
Suggerimenti per la gestione consigliati	Riprova a inviare la richiesta. Contattaci se l'errore persiste.
Suggerimenti per la prevenzione	N/A

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	N/A
Suggerimenti per la gestione consigliati	N/A
Suggerimenti per la prevenzione	Assicurati che il formato dell'ID prodotto sia `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	N/A
Suggerimenti per la gestione consigliati	N/A
Suggerimenti per la prevenzione	Assicurati che il tuo 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` anziché `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	N/A
Suggerimenti per la prevenzione	Assicurati che il formato dell'ID prodotto sia `channel:languageCode:countryCode:offerId`.
`[name] The term '<term>' is not allowed`
Riepilogo	Il nome contiene una parola vietata.
Cause comuni	N/A
Suggerimenti per la gestione consigliati	Utilizza un nome consentito. Per ulteriori informazioni, consulta l'articolo del Centro assistenza sulla specifica del feed.
Suggerimenti per la prevenzione	N/A
`[price.currency] Please use a currency that is supported in the target country`
Riepilogo	È stata specificata una valuta che non è disponibile nel paese di destinazione.
Cause comuni	N/A
Suggerimenti per la gestione consigliati	Assicurati che la valuta e il paese siano specificati correttamente. Per ulteriori informazioni, consulta la sezione su `price` nell'articolo del Centro assistenza sulla specifica del feed.
Suggerimenti per la prevenzione	N/A
`[storeCode] storeCode must be 'online'`
Riepilogo	Ho provato ad aggiornare il prezzo e la disponibilità di un prodotto online tramite il feed di inventario, ma abbiamo specificato un valore diverso dal valore speciale `online` come ID negozio nell'URL.
Cause comuni	N/A
Suggerimenti per la gestione consigliati	Modifica l'ID negozio 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 query di inventario.
`[<attribute>]`
Riepilogo	L'elemento specificato tra parentesi quadre non è valido.
Cause comuni	N/A
Suggerimenti per la gestione consigliati	Correggi la specifica dell'elemento problematico, consulta l'articolo del Centro assistenza sulla specifica del feed per ulteriori informazioni.
Suggerimenti per la prevenzione	N/A

notFound

`Item not found`
Riepilogo	L'elemento che hai provato a recuperare, aggiornare o eliminare non esiste.
Cause comuni	Stai tentando di eliminare un prodotto che non esiste o non hai specificato correttamente l'ID prodotto nell'URL per l'eliminazione.
Suggerimenti per la gestione consigliati	Ricevi un elenco di prodotti utilizzando `Products.list` e prova solo a ricevere, aggiornare o eliminare gli articoli visualizzati. Assicurati di specificare l'ID prodotto nel formato `channel:languageCode:countryCode:offerId`, ad esempio: `online:ru:RU:277104-ekb`, anziché l'ID offerta, che ha il seguente aspetto: `277104-ekb`.
Suggerimenti per la prevenzione	N/A

not_inserted

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

quota

`too_many_items: Merchant quota exceeded`
Riepilogo	Troppi articoli caricati su Google Shopping.
Cause comuni	I prodotti che non vengono convalidati 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 il numero eccessivo di prodotti non validi, come indicato sopra. Inoltre, specifica le date di scadenza quando carichi i prodotti. Quando viene raggiunta la data di scadenza, il prodotto viene eliminato automaticamente. Tieni presente che la data di scadenza predefinita e massima è di 30 giorni dopo l'inserimento o l'aggiornamento del prodotto. Nota: la quota per gli articoli di un account multi-cliente viene verificata rispetto al numero totale di prodotti in tutti i subaccount. Se visualizzi questo errore relativo a un subaccount, assicurati che sia il subaccount sia l'AMC dispongano di una quota prodotti sufficiente. Se hai provato queste soluzioni e stai ancora esaurendo lo spazio per nuovi prodotti nel tuo account Merchant Center, puoi richiedere la possibilità di inviare altri articoli nel tuo account.
Suggerimenti per la prevenzione	Consulta la sezione Suggerimenti consigliati per la gestione.
`too_many_subaccounts: Maximum number of subaccounts reached`
Riepilogo	Hai il numero massimo di subaccount consentiti per il tuo account multi-cliente.
Cause comuni	N/A
Suggerimenti per la gestione consigliati	Elimina i subaccount obsoleti. Se tutti i tuoi account sono attivi, puoi richiedere la possibilità di creare subaccount aggiuntivi nel tuo AMC.
Suggerimenti per la prevenzione	N/A
`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 al minuto elencate nei limiti di pubblicazione. Se superi queste soglie, riceverai questo errore. A volte c'è un picco di traffico che causa questo problema o il server si espande a un numero maggiore di thread.
Suggerimenti per la gestione consigliati	Riduci le richieste totali inviate al minuto.
Suggerimenti per la prevenzione	Quando ricevi questo errore, utilizza strategie di backoff programmatico per ridurre la percentuale di richieste a un livello sostenibile adeguato.
`daily_limit_exceeded: merchant quota exceeded`
Riepilogo	Stai effettuando più richieste al giorno del numero consentito per il metodo di servizio specificato.
Cause comuni	Fai riferimento alle quote giornaliere elencate nei limiti di pubblicazione. Se superi queste soglie, riceverai questo errore.
Suggerimenti per la gestione consigliati	Se possibile, riduci le richieste totali inviate al giorno combinando più modifiche in un'unica richiesta. Valuta la possibilità di raggruppare le modifiche in batch ai prodotti in un periodo di tempo appropriato per evitare di cambiare rapidamente un prodotto più volte. Per gli aggiornamenti degli elementi 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 ricevere un maggior numero di chiamate giornaliere a un determinato metodo, contattaci comunicandoci il tuo ID Merchant Center, i metodi per i quali stai raggiungendo i limiti di quota, una stima del numero di chiamate al giorno necessarie per questi metodi e le motivazioni alla base di questi metodi. Ti contatteremo anche per aumentare la tua quota.
Suggerimenti per la prevenzione	Consulta la sezione Suggerimenti consigliati per la gestione.
`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 la sezione Suggerimenti consigliati per la gestione.
`request_too_large`
Riepilogo	Stai inviando troppi `entries` per richiesta batch o stai superando il limite di dimensioni di `custombatch` richieste.
Cause comuni	Puoi includere un massimo di 10.000 `entries` per richiesta `custombatch` e il limite per la dimensione di trasferimento compressa è di 32 MB.
Suggerimenti per la gestione consigliati	Suddividi il batch in più batch al di sotto dei limiti, quindi riprova.
Suggerimenti per la prevenzione	Ti consigliamo di non inviare più di 1000 voci per batch.

di provisioning.

`[price.value] Required parameter: price.value`
Riepilogo	Prezzo senza valore specificato. Ad esempio: `{ "currency": "USD" }` anziché `{ "value": 123, "currency": "USD" }`.
Cause comuni	N/A
Suggerimenti per la gestione consigliati	Assicurati che il parametro, qui `price`, sia nel formato corretto. Ad esempio, `price` ha due campi obbligatori: `value` e `currency`.
Suggerimenti per la prevenzione	N/A
`[product] INSERT request must specify product`
Riepilogo	È stata inviata all'API una richiesta batch personalizzata contenente una voce con `"method": "insert"`, ma nessun prodotto.
Cause comuni	Hai dimenticato 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 le voci batch con il metodo `get` o `delete` specifichino un ID prodotto.
`[productId] DELETE request must specify productId`
Riepilogo	È stata inviata all'API una richiesta batch personalizzato contenente una voce con `"method": "delete"`, ma nessun ID prodotto.
Cause comuni	Hai dimenticato 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 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	Fai riferimento ai limiti per le richieste HTTP elencati nella pagina relativa ai limiti di pubblicazione. Se superi queste soglie, riceverai questo errore. A volte c'è un picco di traffico che causa questa operazione o il server si espande a un numero maggiore di thread.
Suggerimenti per la gestione consigliati	Riduci le richieste totali inviate al minuto. Il raggruppamento di più chiamate di metodo 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 backoff programmatico e di batch per ridurre la percentuale di richieste a un livello sostenibile adeguato.

validation

`[adwords_redirect]`
Riepilogo	È stato inviato un prodotto il cui campo `adwords_redirect` non è un URL valido.
Cause comuni	N/A
Suggerimenti per la gestione consigliati	Assicurati che il valore del campo `adwords_redirect` sia un URL valido.
Suggerimenti per la prevenzione	N/A
`[item] auth/frontend/not_claimed`
Riepilogo	L'URL del sito web del commerciante non è stato rivendicato in Merchant Center.
Cause comuni	N/A
Suggerimenti per la gestione consigliati	Rivendica l'URL in Merchant Center. La procedura dettagliata è disponibile nel Centro assistenza.
Suggerimenti per la prevenzione	N/A
`[energy_efficiency_class] validation/feed`
Riepilogo	Sono stati specificati sia `energyEfficiencyClass` che prezzo unitario per lo stesso prodotto.
Cause comuni	N/A
Suggerimenti per la gestione consigliati	Specifica solo la classe energetica o il prezzo unitario, non entrambi.
Suggerimenti per la prevenzione	N/A
`[item] internal`
Riepilogo	Si è verificato un errore interno.
Cause comuni	N/A
Suggerimenti per la gestione consigliati	Riprova a inviare la richiesta. Contattaci se l'errore persiste.
Suggerimenti per la prevenzione	N/A
`[item_group_id] invalid_attribute`
Riepilogo	È stato inviato un articolo con `itemGroupId` e molti valori per un attributo delle varianti (colore, taglia, motivo o materiale).
Cause comuni	Specifica di più di una taglia per un prodotto mentre specifichi un ID gruppo di articoli.
Suggerimenti per la gestione consigliati	Invia un prodotto diverso per ogni valore di un determinato attributo variante, ad esempio `size`.
Suggerimenti per la prevenzione	N/A
`[additional_image_link] invalid_attribute`
Riepilogo	Inviati più di 10 link immagine aggiuntivi.
Cause comuni	N/A
Suggerimenti per la gestione consigliati	Limita il numero di link immagine aggiuntivi a 10.
Suggerimenti per la prevenzione	N/A
`[<attribute>] invalid_character`
Riepilogo	Inviati un brand, una descrizione o un altro attributo come stringa che non viene analizzata utilizzando la codifica della richiesta specificata.
Cause comuni	N/A
Suggerimenti per la gestione consigliati	Controlla il messaggio per scoprire quale attributo causa il problema, poi convalida la codifica del testo del valore corrispondente prima di inviarlo di nuovo. L'API accetta solo caratteri UTF-8 validi.
Suggerimenti per la prevenzione	N/A
`[<attribute>] invalid_value`
Riepilogo	Colore, descrizione o altro attributo inviato non valido.
Cause comuni	N/A
Suggerimenti per la gestione consigliati	Per assicurarsi che tutti gli attributi siano conformi alla specifica del feed, consulta l'articolo del Centro assistenza sulla specifica del feed per ulteriori informazioni. Per problemi relativi a GTIN o MPN, consulta l' articolo del Centro assistenza sui codici identificativi di prodotto.
Suggerimenti per la prevenzione	N/A
`[<attribute>] missing_recommended` / `missing_required`
Riepilogo	Prodotto inviato senza un attributo obbligatorio/consigliato.
Cause comuni	N/A
Suggerimenti per la gestione consigliati	Assicurati di includere tutti gli attributi consigliati / obbligatori per il tuo prodotto. Per ulteriori informazioni, consulta l'articolo del Centro assistenza sulla specifica del feed.
Suggerimenti per la prevenzione	N/A
`[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	N/A
Suggerimenti per la gestione consigliati	Assicurati che gli URL dei prodotti inviati corrispondano al sito web rivendicato da Merchant Center.
Suggerimenti per la prevenzione	N/A