Problemi noti

Questa pagina documenta i problemi noti degli sviluppatori con l'API Merchant.

Errori casuali UnauthenticatedException

Segnalato: 30-03-2026 UTC | Ultimo aggiornamento: 17-04-2026 UTC

Diversi clienti riscontrano errori intermittenti UnauthenticatedException durante il caricamento dei prodotti e l'accesso ad altre API Merchant Center. Gli errori si verificano in modo casuale, anche in caso di nuovi tentativi, e interessano sia le chiamate iniziali sia i tentativi successivi. Alcune connessioni non vanno a buon fine, mentre altre riescono in un breve periodo di tempo.

È stata implementata una mitigazione ed è in corso un'indagine per trovare una soluzione permanente. Se riscontri questo errore, ti consigliamo di riprovare a effettuare le chiamate API.

Messaggi di latenza elevata, DEADLINE_EXCEEDED e INTERNAL_ERROR per i metodi di prodotti e inventari

Segnalato: 18-03-2026 UTC | Risolto: 31-03-2026 UTC

Alcuni utenti hanno riscontrato una latenza prolungata e messaggi DEADLINE_EXCEEDED o INTERNAL_ERROR frequenti quando utilizzavano i metodi productInputs e regionalInventories. La causa principale è stata identificata come un incidente a livello di backend che ha influito sull'efficienza di elaborazione.

Risoluzione: questo incidente è stato completamente mitigato il 31 marzo 2026. Dopo la mitigazione, le percentuali di errore sono diminuite in modo significativo. Se continui a riscontrare una latenza elevata, ti consigliamo di verificare i timeout lato client e di ridurre le dimensioni dei batch di richieste.

Problemi di throughput per i metodi insert di prodotti e inventari

Segnalato: 28-01-2026 UTC | Ultimo aggiornamento: 31-03-2026 UTC

Abbiamo ricevuto segnalazioni di problemi di prestazioni lato client con il throughput durante la trasmissione di grandi quantità di dati all'API Merchant. Potresti riscontrare questo problema quando utilizzi le librerie client per i seguenti metodi:

Abbiamo apportato miglioramenti per aumentare il rendimento di vari sistemi di backend. Se continui a riscontrare questo problema, potrebbe essere necessario configurare un pool di canali per massimizzare il throughput. In questo modo, viene aggirato il limite tipico di 100 stream di un singolo canale gRPC gestendo più connessioni sottostanti. Per ulteriori informazioni, consulta la sezione Refactoring del codice per le richieste simultanee: migliorare il throughput con i pool di canali.

Codici identificativi di prodotto con caratteri speciali

Segnalato: 03-10-2025 UTC | Ultimo aggiornamento: 08-04-2026 UTC

Gli utenti potrebbero riscontrare problemi durante la gestione dei prodotti in cui productId o offerId non rispettano le linee guida per la formattazione degli ID prodotto. Questi ID prodotto potrebbero contenere caratteri speciali, in particolare barre (/), due punti (:), tilde (~) e segni di percentuale (%). Le piattaforme come Merchant Center consentono già l'utilizzo di alcuni caratteri speciali negli ID prodotto.

Poiché l'API Merchant incorpora l'ID prodotto direttamente nel name della risorsa come parte dell'URL (ad esempio accounts/{account}/products/{productId}), questi caratteri possono interferire con il routing e l'analisi degli URL standard, causando errori imprevisti 404 Not Found o 400 Bad Request durante le operazioni GET, PATCH o DELETE.

Per interagire in sicurezza con i prodotti che contengono questi caratteri, devi codificare il segmento productId o offerId del nome della risorsa. L'algoritmo di codifica è la codifica Base64URL senza padding. Per ulteriori informazioni, consulta accounts.productInputs.name.

Risolto: abbiamo implementato una soluzione per standardizzare il comportamento nell'ecosistema dell'API Merchant. Abbiamo aggiunto un nuovo campo base64_encoded_name alle risposte dell'API che fornisce il nome della risorsa pre-codificato, che ti consente di utilizzare l'output di una chiamata list o get direttamente come input per gli aggiornamenti successivi senza eseguire la codifica manuale.

Ritardo dopo la creazione dell'origine dati

Segnalato: 10-04-2024 UTC | Ultimo aggiornamento: 12-05-2024 UTC

Si è verificato un ritardo noto durante il tentativo di inserire prodotti, promozioni o recensioni immediatamente dopo la creazione di una nuova DataSource. Quando si tentava di inserire elementi entro 5 minuti dalla creazione dell'origine dati, veniva restituito l'errore Data source not found.

Risolto: questo ritardo è stato eliminato, consentendo un'interazione più immediata con le origini dati appena create.

Altri problemi?

Per altri problemi, visita le pagine Richiedere assistenza per l'API Merchant e Inviare feedback.

Indietro
Versioning
Avanti
Overview