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.
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.
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.
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.
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.
[null,null,["Ultimo aggiornamento 2024-07-03 UTC."],[[["This guide outlines common errors when using the Google Merchant API, categorized for easier understanding."],["Errors can relate to authentication, data conflicts, invalid data, missing information, or exceeding usage limits."],["Solutions include verifying user permissions, correcting product data, and adjusting request frequency."],["Refer to linked resources for detailed specifications, usage limits, and account management."],["This guide aids in troubleshooting and preventing common issues when interacting with the Google Merchant API."]]],[]]
