In breve: Mancano quattro settimane. La Content API for Shopping v2.1 si spegne il 18 agosto 2026 e non ci sarà proroga. Questo è il piano del conto alla rovescia per il tempo che resta. Un grep che trova ogni integrazione destinata a morire, prima migri i percorsi dei soldi, poi quelli di lettura, e alla fine un funzionamento in parallelo per spegnere la vecchia API da solo, prima che lo faccia Google al posto tuo.
Stamattina è scattato il promemoria. L’avevo impostato a giugno, il giorno in cui ho scritto della chiusura della Content API, e l’avevo piazzato esattamente quattro settimane prima della scadenza. Il 18 agosto 2026 Google spegne la Content API for Shopping v2.1 per sempre. Quattro settimane bastano per migrare con calma. Bastano anche per convincerti che lo farai la settimana prossima, quattro volte di fila.
Ho già spiegato cosa si rompe e perché la Merchant API è lo strumento migliore nell’articolo di giugno. Non mi ripeto. Questo è il piano che seguo quando una scadenza dura si avvicina. Una settimana per fase.
Questa settimana, trova tutto quello che morirà
Non puoi migrare quello che non hai trovato. Lancia questo su ogni repo che tocca Merchant Center:
grep -rEn \
"shoppingcontent\.googleapis\.com|ShoppingContent|content/v2(\.1)?([^[:alnum:]_.-]|$)|[\"']content[\"'][,[:space:]]+[\"']v2(\.1)?[\"']|\.content\([\"']v2(\.1)?[\"']" .Il primo pattern cattura le chiamate REST dirette. Gli altri catturano le librerie client ufficiali, perché ti nascondono l’URL. Python costruisce il client condannato con build('content', 'v2.1'), PHP lo chiama Google_Service_ShoppingContent, Node usa google.content('v2.1') e i progetti Apps Script caricano un servizio avanzato ShoppingContent che non compare in nessun repo. I progetti di script controllali a mano.
Poi metti ogni risultato in un foglio con quattro colonne. Cosa fa, ogni quanto gira, chi ne è responsabile e quanto tempo passerà prima che qualcuno si accorga che è morto in silenzio. È l’ultima colonna quella per cui ordini.
Il tuo grep copre solo il codice che hai scritto tu. Gli scenari Zapier, i tool per i feed, i repricer e i connettori possono poggiare anche loro sulla vecchia API. Scrivi questa settimana a ogni fornitore e chiedi la sua data Merchant API per iscritto. La sua scadenza di migrazione è il tuo disservizio.
Settimana due, migra i percorsi dei soldi
Parti da dove il silenzio costa fatturato. Aggiornamenti di prezzo, aggiornamenti di stock, caricamenti dei feed. Nella Merchant API v1, GA da luglio 2025, vivono nelle sub-API products, inventories e datasources, e la guida alla compatibilità mappa le vecchie chiamate sulle nuove destinazioni.
Una cosa mi ha sorpreso in positivo quando da Lynt abbiamo puntato i nostri strumenti sui nuovi endpoint. Il token OAuth esistente con il vecchio scope content ha funzionato e basta. Le credenziali si portano dietro, il codice no. Riscrivi le chiamate e ti risparmi un nuovo giro di autorizzazioni con ogni cliente.
Settimana tre, i percorsi di lettura
I controlli dei rifiuti e il reporting si spostano dopo. Questa è anche la settimana in cui la migrazione inizia a ripagarti. I report paginano a 1.000 righe invece di 250, quindi lo stesso job finisce con un quarto delle chiamate. E dove il tuo vecchio codice interrogava gli stati dei prodotti a orari fissi, la sub-API notifications ti spinge i cambiamenti da sola.
Settimana quattro, spegnila tu
Fai girare le due pipeline in parallelo e confronta gli output per qualche giorno. Poi spegni la vecchia integrazione circa una settimana in anticipo, di proposito, finché la v2.1 risponde ancora. Se qualcosa che ti è sfuggito ne dipende in segreto, emerge mentre puoi ancora riattivare le vecchie chiamate per un giorno e sistemare le cose per bene.
Dopo il 18 agosto non c’è rollback. Google abbassa l’interruttore per tutti insieme, e quello che il grep non ha trovato muore in produzione.
Dodici anni sulla Google Ads API mi hanno insegnato che le scadenze dure sono rare. Google di solito proroga, tollera il vecchio, rimanda. Questa no. Quindi lancia il grep prima di chiudere questa scheda. Il numero che stampa è l’unica stima di migrazione di cui hai bisogno.
