L'inventario v1 è una struttura gerarchica di entità del feed in formato JSON-LD. Questo schema ha consentito ai partner del programma di accesso in anteprima di utilizzare lo schema per l'integrazione con End-to-end di ordinazione. Lo schema dell'inventario v1 è deprecato.
L'ultima versione della specifica del feed di dati, l'inventario v2, ha una struttura piatta e utilizza un modello a schema relazionale. Ciò consente ai partner di estrarre e trasformare le entità dal proprio database relazionale in modo più semplice per creare i feed di dati. L'inventario v2 è in formato NDJSON, un formato JSON delimitato da una nuova riga.
Perché eseguire la migrazione dalla v1 alla v2
Anche se continuiamo a fornire assistenza per la manutenzione ai partner con integrazioni dello schema di inventario end-to-end v1 dell'ordine, tutte le nuove integrazioni dei partner devono utilizzare l'inventario v2.
Le nuove funzionalità nell'inventario v2 potrebbero non essere disponibili nell'inventario v1. Per un esempio, consulta la sezione Deal.
Passi per la migrazione
L'utilizzo dell'inventario v2 richiede un progetto end-to-end di ordinazione separato e una nuova integrazione. Il seguente processo spiega come eseguire la migrazione di un inventario v1 a un inventario v2.
- Per creare un nuovo progetto v2, devi prima completare i passaggi di integrazione.
- Per implementare i feed di dati, utilizza lo schema di inventario relazionale.
- Se applicabile, riutilizza l'endpoint di evasione del progetto v1.
- Quando il tuo progetto v2 è pronto per il lancio, segui questi passaggi:
- Assicurati che il tuo progetto v2 soddisfi l'elenco di controllo per l'idoneità al lancio.
- Per impedire agli utenti finali di pubblicare lo schema dell'inventario v1 e v2, annulla il deployment della release di produzione dal progetto v1. L'inventario del progetto v1 interrompe la pubblicazione in produzione entro pochi minuti dopo questo passaggio.
- Crea una release di produzione per il tuo progetto v2 e invia una notifica al tuo consulente Google.
Passaggi di rollback
Se vuoi eseguire il rollback alla versione v1 dopo il deployment del progetto v2 in produzione, puoi annullare il deployment della release di produzione nel progetto v2, quindi eseguire nuovamente il deployment della release di produzione del progetto v1.
Impatto sui dati dei partner e sul ranking dei fornitori
Di seguito sono riportate le potenziali conseguenze sui dati dei partner e sul ranking dei fornitori.
- I log delle transazioni e i dati di analisi del progetto v1 non vengono trasferiti al progetto v2.
- Le metriche relative alle prestazioni, come i tassi di conversione e le metriche API del progetto v1, non vengono trasferite nel progetto v2. Questa operazione reimposta il ranking del tuo fornitore in Ordine end-to-end.