Halaman ini menunjukkan cara membuat dan memperbarui sumber data secara terprogram Anda dapat menyisipkan produk. Data otomatis sumber data sehingga lebih mudah untuk mengirim data produk Anda ke Google. Sumber data otomatis memastikan bahwa yang paling informasi terbaru tentang produk yang relevan dari situs Anda menjangkau Google.
Content API for Shopping hanya memungkinkan Anda membuat sumber data utama. Dengan API sumber Data Penjual, Anda dapat membuat jenis sumber data berikut:
- Sumber data produk utama
- Sumber data produk tambahan
- Sumber data inventaris lokal
- Sumber data inventaris regional
- Sumber data promosi
Content API for Shopping hanya mengizinkan pengelolaan sumber data dengan input file. Merchant API memungkinkan Anda mengelola sumber data dengan input file dan API.
Dengan menggunakan API sumber Data Penjual, Anda dapat melakukan hal berikut:
- Buat sumber data utama baru dengan
feedLabel
dancontentLanguage
. - Buat sumber data karakter pengganti. Sumber data karakter pengganti tidak memiliki
feedLabel
dancontentLanguage
kolom ditetapkan. Sumber data karakter pengganti memungkinkan Anda menyisipkan produk dengan kombinasifeedLabel
dancontentLanguage
yang berbeda ke dalam sumber data. - Buat sumber data tambahan untuk ditautkan ke sumber data utama yang ada.
- Siapkan jadwal untuk sumber data file.
- Daftarkan akun Anda untuk pengelolaan sumber data otomatis.
- Mengelola sumber data API.
- Kelola aturan default sumber data menggunakan sumber data produk utama.
- Gunakan jenis sumber data lain seperti promosi.
Prasyarat
- Akun Anda harus sudah dimigrasikan ke feed lokalitas tunggal.
Untuk memverifikasi bahwa akun sudah dimigrasikan ke pemisahan target data, gunakan daftar sumber data atau metode get. Jika Anda tidak memenuhi syarat, Anda akan menerima pesan pengecualian berikut dan Anda harus menghubungi tim dukungan.
This account is in the data sources migration process and can't be used with this API yet. Contact support for more info on when this account will be able to use the data sources endpoint.
Membuat sumber data baru
Untuk membuat sumber data utama baru dengan feedLabel
dan
contentLanguage
, tetapkan kolom feedLabel
dan contentLanguage
di
konfigurasi khusus jenis, {i>type-specific configuration<i}. Misalnya, PrimaryProductDataSource
.
Untuk melihat sumber data yang baru dibuat, buat permintaan GET
atau LIST
.
Buat sumber data utama karakter pengganti baru
Untuk membuat feed utama karakter pengganti baru, konfigurasikan sumber data Anda menggunakan
PrimaryProductDataSource
dan jangan setel kolom feedLabel
dan contentLanguage
.
Dengan menggunakan Content API for Shopping, hanya ada satu sumber data API yang dibuat untuk maksimal. Dengan menggunakan API sumber Data Penjual, Anda dapat memiliki beberapa sumber data API, beberapa di antaranya dapat berupa karakter pengganti.
Hanya sumber data dengan input API yang dapat menjadi sumber data karakter pengganti. Data karakter pengganti tidak didukung untuk input file.
Membuat sumber data tambahan dan menautkannya ke sumber data utama
Anda dapat menggunakan sumber data tambahan untuk melakukan pembaruan parsial pada data produk dengan
menambahkan ID unik sumber data sebagai parameter kueri saat melakukan
panggilan ke
accounts.productInputs.insert
dan
accounts.productInputs.delete
metode. Anda hanya dapat menggunakan sumber data tambahan untuk memperbarui produk yang sudah ada.
Untuk membuat sumber data tambahan, konfigurasi sumber data Anda menggunakan
SupplementalProductDataSource
, lalu tautkan dengan memperbarui defaultRule
kolom di sumber data utama Anda.
Sumber data file tambahan tidak boleh merupakan sumber data karakter pengganti. API Tambahan sumber data harus selalu berupa sumber data karakter pengganti.
Menyiapkan jadwal untuk sumber data file
Untuk menyiapkan jadwal feed file, konfigurasikan sumber data Anda menjadi file
sumber data menggunakan kolom FileInput
, lalu siapkan
fetchsettings
menggunakan kolom FileInput.FetchSettings
.
Menghapus sumber data
Untuk menghapus sumber data yang ada dari akun, gunakan
accounts.dataSources.delete
.
Mengambil sumber data
Untuk mengambil file yang dikonfigurasi di sumber data, gunakan
accounts.dataSources.fetch
. Metode ini melakukan pengambilan data secara langsung pada sumber data dari
akun Anda. Metode ini hanya berfungsi pada sumber data dengan kumpulan input file.
Mendapatkan sumber data
Untuk mengambil konfigurasi sumber data untuk akun Anda, gunakan
accounts.dataSources.get
.
Daftar sumber data
Untuk menampilkan daftar konfigurasi sumber data untuk akun Anda, gunakan
accounts.dataSources.list
.
Mem-patch sumber data
Untuk memperbarui konfigurasi sumber data yang ada, gunakan
accounts.dataSources.patch
.
Menautkan sumber data
Sumber data produk utama memungkinkan Anda mengelola setelan default aturan sumber data. Aturan default adalah aturan yang berlaku untuk semua dalam sumber data Anda. Aturan default dapat ditetapkan saat membuat atau dengan memperbarui sumber data yang ada melalui aturan default kolom tersebut.
Contoh konfigurasi berikut memastikan bahwa semua atribut pertama kali diambil
dari sumber data dengan ID unik 1001
. Kemudian yang hilang
atribut ditambahkan dari sumber data utama. Pada akhirnya, sisa
akan diambil dari sumber data tambahan dengan
ID 1002
jika belum disediakan di sumber data lainnya. Jika sama
disediakan dalam beberapa sumber data, nilai yang lebih tinggi dalam daftar adalah
dipilih.
defaultRule {
takeFromDataSources: [
'1001', // Supplemental product data source
'self', // Self reference to the primary data source
'1002' // Supplemental product data source
]
}
Pengelolaan otomatis feed
Guna mendaftarkan akun Anda untuk pengelolaan sumber data otomatis, Anda harus melakukan berikut ini:
- Periksa apakah akun Anda memenuhi syarat untuk pendaftaran dengan menghubungi
Metode
Accounts.AutofeedSettings.Get
. - Pastikan akun Anda bukan marketplace menggunakan akun layanan.
Setelah akun Anda memenuhi syarat untuk pendaftaran, Anda dapat menggunakan
Metode Accounts.AutofeedSettings.Update
untuk mengaktifkan pengelolaan data otomatis
sumber. Mengaktifkan pengelolaan sumber data otomatis memungkinkan Google secara otomatis
menambahkan produk dari toko online Anda dan memastikan produk tersebut selalu terbaru
di platform Google.
Mengambil status upload file
Untuk mendapatkan status sumber data dengan file, pengambilan, atau {i>spreadsheet<i}, Anda dapat
dapat memanggil metode GET
dari layanan FileUpload
. Untuk mendapatkan hasil
pengambilan terakhir sumber data dihitung secara asinkron saat data
pemrosesan sumber selesai, gunakan ID nama latest
.
GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest
Status upload file mungkin berisi tampilan mendetail produk Anda, termasuk potensi masalah apa pun.
Perhatikan bahwa status upload file mungkin tidak ada jika file tidak pernah diupload. Status upload file mungkin berada dalam status pemrosesan jika diminta segera setelahnya file diunggah.