Memigrasikan sumber data

Panduan ini menjelaskan cara memigrasikan integrasi Anda dari layanan datafeeds dan datafeedstatuses Content API for Shopping ke sub-API Sumber data di Merchant API. Sub-API Sumber data baru memberikan kontrol yang lebih langsung atas pipeline data Anda dan menyederhanakan pengelolaan sumber data.

Untuk mengetahui informasi selengkapnya tentang fitur baru, lihat panduan Mengelola sumber data.

Perbedaan utama

Dibandingkan dengan Content API for Shopping, Merchant API menawarkan beberapa keuntungan.

• Pembuatan sumber data eksplisit. API tidak lagi otomatis membuat sumber data "Content API" saat Anda memasukkan produk pertama. Di Merchant API, Anda harus membuat sumber data secara eksplisit sebelum dapat mengupload produk ke sumber data tersebut. Hal ini memberi Anda lebih banyak kontrol atas organisasi dan pengelolaan pipeline data produk sejak awal.

• Dukungan untuk beberapa sumber data API. Di Content API for Shopping, Anda dibatasi untuk menggunakan satu sumber data "Content API" yang dibuat secara otomatis. Dengan Merchant API, Anda dapat membuat dan mengelola beberapa sumber data jenis input API.

• Sumber data tanpa label dan bahasa. Merchant API memungkinkan Anda membuat sumber data utama tanpa menentukan feedLabel dan contentLanguage. Jenis sumber data ini menerima produk dalam kombinasi feedLabel dan contentLanguage apa pun, yang menyederhanakan upload produk untuk integrasi yang tidak memerlukan sumber data terpisah untuk berbagai wilayah.

• Target data yang disederhanakan. Setiap sumber data kini sesuai dengan satu target, yang ditentukan oleh kombinasi unik feedLabel dan contentLanguage. Feed target multi-data tidak digunakan lagi di Merchant API.

• Status upload file khusus. Merchant API menampilkan status sumber data berbasis file menggunakan resource fileUploads hanya baca yang terpisah. Untuk mengambil status upload file, gunakan metode fileUploads.get dengan alias latest.

• Jenis sumber data baru. Resource DataSource mendukung lebih banyak vertikal, termasuk promosi, inventaris lokal, dan inventaris regional, sehingga memberikan cara terpadu untuk mengelola semua pipeline data Anda.

• Sumber data otomatis. Dengan Merchant API, Anda kini dapat mengaktifkan atau menonaktifkan fitur Sumber data otomatis untuk akun Anda menggunakan metode autofeedSettings.updateAutofeedSettings di sub-API Akun. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi setelan Feed Otomatis.

Permintaan

Tabel berikut membandingkan format URL permintaan antara Content API for Shopping dan Merchant API.

Deskripsi permintaan	Content API for Shopping	Merchant API
Membuat sumber data	POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds	POST https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources
Mendapatkan sumber data	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}	GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
Mencantumkan sumber data	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds	GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources
Memperbarui sumber data	PUT https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}	PATCH https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
Menghapus sumber data	DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}	DELETE https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
Mengambil sumber data	POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}/fetchNow	POST https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}:fetch
Mendapatkan status sumber data	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeedstatuses/{DATAFEED_ID}	GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}/fileUploads/latest
Mencantumkan status sumber data	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeedstatuses	Tidak tersedia. Gunakan dataSources.list dan fileUploads.get untuk setiap sumber data berbasis file.

Pengenal

Merchant API menggunakan nama resource berbasis string sebagai ID.

Deskripsi ID	Content API for Shopping	Merchant API
ID sumber data	datafeedId (numerik)	name (string, format: accounts/{account}/dataSources/{datasource})

Metode

Tabel ini membandingkan metode dari layanan datafeeds dan datafeedstatuses Content API for Shopping dengan metode yang setara di Merchant API.

Metode Content API for Shopping	Metode Merchant API	Ketersediaan dan catatan
datafeeds.custombatch	Tidak tersedia	Gunakan panggilan API individual sebagai gantinya.
datafeeds.delete	dataSources.delete	Tersedia.
datafeeds.fetchnow	dataSources.fetch	Tersedia. Metode ini sekarang hanya berfungsi untuk sumber data dengan input file.
datafeeds.get	dataSources.get	Tersedia.
datafeeds.insert	dataSources.create	Tersedia.
datafeeds.list	dataSources.list	Tersedia.
datafeeds.update	dataSources.update	Tersedia. Menggunakan semantik PATCH, bukan PUT.
datafeedstatuses.custombatch	Tidak tersedia	Gunakan panggilan API individual sebagai gantinya. Lihat Mengirim beberapa permintaan sekaligus untuk mengetahui detail selengkapnya.
datafeedstatuses.get	fileUploads.get	Tersedia untuk sumber data berbasis file. Gunakan alias latest untuk mendapatkan status upload terbaru. Untuk jenis sumber data lainnya, informasi status adalah bagian dari resource DataSource.
datafeedstatuses.list	Tidak tersedia	Untuk mendapatkan status beberapa sumber data, cantumkan terlebih dahulu semua sumber data dengan dataSources.list. Kemudian, panggil fileUploads.get dengan alias latest untuk setiap sumber data berbasis file.

Perubahan kolom mendetail

Tabel ini menunjukkan perubahan tingkat kolom antara resource Datafeed dan DatafeedStatus di Content API for Shopping serta resource DataSource dan FileUpload di Merchant API.

Content API for Shopping	Merchant API	Deskripsi
Datafeed	DataSource	Resource utama untuk konfigurasi sumber data.
id	name	ID resource. Diubah dari ID numerik menjadi nama resource string.
name	displayName	Nama sumber data yang ditampilkan kepada pengguna.
attributeLanguage	primaryProductDataSource.contentLanguage	Kode bahasa ISO 639-1 dua huruf untuk item di sumber data.
fileName	fileInput.fileName	Nama file yang diupload. Kolom ini kini berada di bawah fileInput.
fetchSchedule	fileInput.fetchSettings	Jadwal untuk mengambil sumber data berbasis file. Sekarang, fungsi ini bertingkat di bagian fileInput.
fetchSchedule.paused	fileInput.fetchSettings.enabled	Logikanya terbalik. paused: true setara dengan enabled: false.
format	Tidak tersedia	Kolom fileEncoding, columnDelimiter, dan quotingMode dihapus. Sekarang terdeteksi secara otomatis.
targets	primaryProductDataSource.feedLabel, primaryProductDataSource.contentLanguage, primaryProductDataSource.countries	Kolom targets berulang dihapus. Setiap sumber data kini memiliki satu target yang ditentukan oleh kolom ini, yang mencerminkan penghentian penggunaan feed multi-target data.
DatafeedStatus	FileUpload	Status upload file kini menjadi resource terpisah yang hanya dapat dibaca.
datafeedId	name	ID untuk upload file, yang mereferensikan sumber data induknya.
processingStatus	processingState	Status pemrosesan upload. Nilai string (success, failure, in progress) diganti dengan enum (SUCCEEDED, FAILED, IN_PROGRESS).
errors, warnings	issues	Error dan peringatan digabungkan ke dalam satu daftar issues. Setiap masalah memiliki kolom severity (ERROR atau WARNING).
lastUploadDate	uploadTime	Stempel waktu upload terakhir. Format diubah dari string menjadi objek Timestamp.
country, language, feedLabel	Tidak berlaku	Kolom ini tidak lagi ada di resource status. Header ini adalah bagian dari resource DataSource.
targets[].included_destinations, targets[].excluded_destinations	primaryProductDataSource.destinations	Dua daftar terpisah untuk tujuan yang disertakan dan dikecualikan digantikan oleh satu daftar destinations. Setiap item dalam daftar baru adalah objek yang menentukan tujuan dan statusnya (ENABLED atau DISABLED), sehingga memberikan konfigurasi yang lebih eksplisit.