Inventaris v1 adalah struktur hierarki entitas feed dalam format JSON-LD. Skema ini memungkinkan partner program akses awal menggunakan skema untuk berintegrasi dengan Pemesanan Menyeluruh. Skema inventaris v1 kini tidak digunakan lagi.
Versi terbaru spesifikasi feed data, inventaris v2, memiliki struktur datar dan menggunakan model skema relasional. Hal ini memungkinkan partner mengekstrak dan mengubah entity dari database relasional mereka dengan cara yang lebih mudah untuk membuat feed data. Inventaris v2 menggunakan NDJSON, yang merupakan format JSON yang dibatasi baris baru.
Alasan Anda harus bermigrasi dari v1 ke v2
Meskipun kami terus memberikan dukungan pemeliharaan kepada partner dengan Pemesanan integrasi skema inventaris v1 Menyeluruh, semua integrasi partner baru harus menggunakan inventaris v2.
Fitur baru di inventaris v2 mungkin tidak tersedia di inventaris v1. Sebagai contoh, lihat Transaksi.
Langkah migrasi
Penggunaan inventaris v2 memerlukan project Pemesanan Menyeluruh yang terpisah dan integrasi baru. Proses berikut menjelaskan cara memigrasikan inventaris v1 ke inventaris v2.
- Untuk membuat project v2 baru, selesaikan langkah-langkah integrasi terlebih dahulu.
- Untuk mengimplementasikan feed data, gunakan skema inventaris relasional.
- Jika berlaku, gunakan kembali endpoint fulfillment dari project v1 Anda.
- Saat project v2 Anda siap diluncurkan, ikuti langkah-langkah berikut:
- Pastikan project v2 Anda memenuhi checklist kesiapan peluncuran.
- Untuk mencegah penayangan skema inventaris v1 dan v2 Anda kepada pengguna akhir, batalkan deployment rilis produksi dari project v1 Anda. Inventaris project v1 Anda berhenti ditayangkan di produksi dalam hitungan menit setelah langkah ini.
- Buat rilis produksi untuk project v2 dan beri tahu konsultan Google Anda.
Langkah rollback
Jika ingin melakukan rollback ke v1 setelah deployment project v2 dalam produksi, Anda dapat membatalkan deployment rilis produksi di project v2, lalu men-deploy ulang rilis produksi project v1.
Dampak terhadap data partner dan peringkat penyedia
Berikut ini potensi dampak terhadap data partner dan peringkat penyedia.
- Log transaksi dan data analisis dari project v1 Anda tidak ditransfer ke project v2 Anda.
- Metrik performa, seperti rasio konversi dan metrik API dari project v1 Anda, tidak ditransfer ke project v2. Tindakan ini akan mereset peringkat penyedia Anda pada Pengurutan Menyeluruh.