Questa pagina documenta i problemi noti degli sviluppatori relativi all'API Merchant.
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. Questo problema potrebbe verificarsi quando utilizzi le librerie client per i seguenti metodi:
accounts.productInputs.insertaccounts.products.localInventories.insertaccounts.products.regionalInventories.insert
Abbiamo apportato miglioramenti per aumentare il rendimento di vari sistemi di backend. Se il problema persiste, 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 saperne di più, consulta 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 dei codici identificativi di prodotto.
Questi codici identificativi di 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 nei codici identificativi di 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 contenenti questi caratteri, devi codificare il segmento productId o offerId del nome della risorsa. L'algoritmo di codifica è la codifica Base64URL senza padding. Per saperne di più, 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, consentendoti 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 un nuovo 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.