In breve: Content API for Shopping v2.1 si spegne il 18 agosto 2026. Quel giorno smettono di funzionare caricamenti del feed, feed supplementari, custom label, aggiornamenti di prezzo e disponibilità e controlli sui prodotti rifiutati. Il successore, Merchant API v1, è in GA da luglio 2025 ed è davvero migliore. ErrorInfo leggibile dalle macchine, paginazione da 1.000 righe, patch parziale dei prodotti. La scadenza più dura dell'anno.
La prima cosa che ho fatto dopo l’annuncio è stata aprire la nostra codebase in Lynt e cercare shoppingcontent.googleapis.com. Ogni risultato è uno script che muore il 18 agosto 2026. Quel giorno Google spegne definitivamente Content API for Shopping v2.1. La Merchant API v1beta intermedia è già stata dismessa il 28 febbraio 2026, e il successore ufficiale, Merchant API v1, è in GA da luglio 2025.
Cosa si rompe davvero
Tutto ciò che parla ancora con la vecchia API. Caricamenti del feed, feed supplementari, custom label, aggiornamenti di prezzo e disponibilità, controlli sui prodotti rifiutati. Se uno script giornaliero ti tiene i prezzi sincronizzati, il 18 agosto ammutolisce e il feed si allontana dalla realtà finché qualcuno non nota il fatturato mancante. Ho visto questo tipo di guasto su account reali. Il costo non è mai l’interruzione in sé, sono le settimane in cui nessuno se ne accorge.
È la scadenza più dura nell’ecosistema pubblicitario di Google quest’anno. Tutto il resto della roadmap può slittare. Questa no.
Perché la migrazione conviene comunque
La Merchant API non è solo un endpoint rinominato. Spezza un monolite in sub-API mirate (datasources, products, inventories, reports, notifications) e sistema tre cose che rendevano fragile l’automazione sulla v2.1:
ErrorInfoleggibile dalle macchine. La tua logica di retry decide in base a un codice di errore invece di confrontare stringhe.- Paginazione portata da 250 a 1.000 righe. Lo stesso report con un quarto delle chiamate.
patchdei prodotti. Aggiorni un campo invece di rispedire l’intero prodotto.
Come gestire la migrazione
Tratta la ricostruzione come l’occasione per irrobustire lo stack, non solo per restare a galla. Mappa ogni vecchia chiamata sulla sua sub-API, collega ErrorInfo al tuo livello di retry e porta i report alla dimensione di pagina più grande. Se gestisci più account, costruisci il connettore una volta sola e distribuiscilo su tutti i clienti. La struttura a sub-API è la stessa ovunque, quindi fai il lavoro una volta e ogni account lo eredita.
Lancia la stessa ricerca che ho fatto io. Cerca shoppingcontent.googleapis.com nella tua codebase e conta i risultati. Ognuno di loro ora ha i giorni contati. Per il quadro completo di come la Merchant API si inserisce nelle altre novità dell’anno, leggi il mio riepilogo dell’anno delle API di Google.
