La data di ritiro ufficiale della Content API for Shopping di Google è stata il 18 agosto 2026. Tutti gli sviluppatori devono eseguire la migrazione delle integrazioni esistenti all' API Merchant il prima possibile.
Per incoraggiare la migrazione prima della disattivazione completa e garantire che gli sviluppatori rispettino gli avvisi di ritiro nei log delle applicazioni, Google introdurrà un processo di riduzione progressiva del servizio a partire dal 1° settembre 2026.
Tabella di marcia per il ritiro
La tabella seguente illustra la tempistica per la riduzione del servizio e la disattivazione finale della Content API for Shopping di Google (v2.1):
| Data | Milestone | Dettagli |
|---|---|---|
| 1° settembre 2026 | Introduzione di richieste non riuscite intermittenti | Le richieste senza un'estensione attiva iniziano a non riuscire in modo intermittente con HTTP 410 Gone. |
| Inizio 2027 | Dismissione | Disattivazione completa. Tutti gli endpoint vengono disattivati e tutte le richieste non vanno a buon fine. |
Riduzione del servizio e risposte agli errori
A partire dal 1° settembre 2026, le richieste inviate agli endpoint dell'API Google Content for Shopping dai client senza un'estensione attiva non andranno a buon fine in modo intermittente con un codice di stato HTTP 410 Gone.
Formato della risposta agli errori
Quando una richiesta viene rifiutata nell'ambito della riduzione del servizio pianificata, l'API restituisce un payload di errore HTTP 410 Gone contenente il messaggio e i metadati con i dettagli del progetto Google Cloud:
{
"error": {
"code": 410,
"message": "Content API for Shopping was sunset on August 18, 2026 for GCP project with id YOUR_PROJECT_ID and number 123456789012. Please migrate to the Merchant API v1 version. See https://developers.google.com/merchant/api/guides/compatibility for more details",
"status": "ABORTED",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "content_api_sunset",
"domain": "shoppingcontent.googleapis.com",
"metadata": {
"GCP_ID": "YOUR_PROJECT_ID",
"GCP_NUMBER": "YOUR_PROJECT_NUMBER",
"HELP_CENTER_LINK": "https://developers.google.com/merchant/api/guides/compatibility"
}
}
]
}
}
La risposta agli errori include i seguenti campi di metadati:
GCP_ID: l'ID del progetto Google Cloud che effettua la richiesta.GCP_NUMBER: l'identificatore numerico univoco del progetto cloud di Google.HELP_CENTER_LINK: un link diretto alla documentazione di migrazione.
Impatto sulle quote
Le risposte agli errori artificiali generate durante la riduzione del servizio non vengono conteggiate ai fini della quota API del progetto.
Ritenta le richieste non riuscite
Poiché la riduzione iniziale del servizio fa sì che solo una parte delle richieste non vada a buon fine, il tentativo di ripetere una richiesta non riuscita potrebbe avere esito positivo. Tuttavia, affidarsi ai tentativi non è una soluzione praticabile a lungo termine, perché le richieste non riuscite diventeranno più frequenti fino a quando tutte le richieste non andranno a buon fine al momento della dismissione.
Sviluppatori interessati
Il processo di ritiro e riduzione del servizio si applica a sviluppatori e aziende come segue:
- Integrazioni API personalizzate:se la tua organizzazione gestisce strumenti interni, script o software personalizzato che effettua chiamate dirette alla Content API for Shopping di Google, devi aggiornare le applicazioni per chiamare l'API Merchant.
- Piattaforme di terze parti:se accedi a Merchant Center tramite una piattaforma di e-commerce, il partner della piattaforma gestisce la migrazione per tuo conto. Non è richiesta alcuna azione da parte tua.
Azione richiesta
Per evitare interruzioni delle schede di prodotto e della gestione dell'account:
- Consulta la panoramica dell'API Merchant per comprendere l'architettura, l'autenticazione e le strutture delle sub-API.
- Segui la guida Eseguire la migrazione dalla Content API for Shopping all'API Merchant per identificare gli equivalenti moderni per i servizi Content API attuali.
- Installa le librerie client dell'API Merchant più recenti per il tuo linguaggio di programmazione.
- Aggiorna e testa l'integrazione in un ambiente di sviluppo prima di eseguirne il deployment in produzione.
Richiedi un'estensione
Se la tua organizzazione ha bisogno di più tempo per completare la migrazione, puoi richiedere un'estensione per esentare temporaneamente il tuo progetto Google Cloud dagli errori di riduzione del servizio. Per richiedere un'estensione, invia il modulo di richiesta di estensione della Content API.
Le estensioni approvate proteggono i tuoi progetti dalle risposte agli errori pianificate durante la finestra di estensione approvata. Le estensioni non vanno oltre la dismissione finale all'inizio del 2027.