Ringkasan API sumber Data Penjual

Halaman ini menunjukkan cara membuat dan memperbarui sumber data secara terprogram yang memungkinkan Anda menyisipkan produk. Data otomatis sumber data sehingga lebih mudah untuk mengirim data produk Anda ke Google. Sumber data otomatis memastikan bahwa informasi terbaru tentang produk yang relevan dari situs Anda sampai ke Google.

Content API for Shopping hanya memungkinkan Anda membuat sumber data utama. Dengan Merchant Data Sources API, Anda dapat membuat jenis sumber data berikut:

Content API for Shopping hanya memungkinkan Anda mengelola sumber data dengan input file. Merchant API memungkinkan Anda mengelola sumber data dengan input file dan API.

Dengan menggunakan Merchant Data sources API, Anda dapat melakukan hal berikut:

  • Buat sumber data utama baru dengan feedLabel dan contentLanguage.
  • Buat sumber data yang tidak memiliki kolom feedLabel dan contentLanguage. Dengan menggunakan jenis sumber data ini, Anda dapat menargetkan beberapa negara untuk produk Anda, karena Anda dapat memasukkan produk dengan berbagai kombinasi feedLabel dan contentLanguage ke dalam satu sumber data.
  • Buat sumber data tambahan untuk ditautkan ke sumber data utama yang ada.
  • Menyiapkan jadwal untuk sumber data file.
  • Daftarkan akun Anda untuk pengelolaan sumber data otomatis.
  • Mengelola sumber data API.
  • Mengelola aturan default sumber data menggunakan sumber data produk utama.
  • Menggunakan jenis sumber data lain seperti promosi.

Anda tidak dapat menggunakan Merchant API untuk menyisipkan produk di sumber data yang berisi produk lokal dan online. Untuk informasi selengkapnya tentang saluran sumber data, lihat Saluran.

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 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

Sumber data utama adalah sumber data utama untuk Merchant Center Anda inventaris Anda. Anda hanya dapat menambahkan atau menghapus produk menggunakan sumber data utama. Jika setiap produk yang Anda tambahkan ke sumber data utama memenuhi data Merchant Center dan persyaratan kelayakan, Anda tidak perlu membuat sumber data lagi.

Untuk membuat sumber data utama baru dengan feedLabel dan contentLanguage tertentu, tetapkan kolom feedLabel dan contentLanguage dalam konfigurasi khusus jenis. Untuk mengetahui informasi selengkapnya tentang kolom ini, lihat PrimaryProductDataSource.

Untuk informasi selengkapnya tentang cara membuat sumber data, lihat metode accounts.dataSources.create.

Untuk melihat sumber data yang baru dibuat, gunakan accounts.dataSources.get atau accounts.dataSources.list .

Membuat sumber data utama baru yang membantu menargetkan beberapa negara

Untuk membuat feed utama baru yang membantu Anda menargetkan beberapa negara, konfigurasikan sumber data menggunakan PrimaryProductDataSource dan jangan tetapkan kolom feedLabel dan contentLanguage.

Dengan menggunakan Content API for Shopping, hanya ada satu sumber data API yang dibuat untuk Anda. Dengan menggunakan API sumber Data Penjual, Anda dapat memiliki beberapa sumber data API, beberapa di antaranya tidak boleh ada kolom feedLabel dan contentLanguage yang ditetapkan.

Hanya sumber data dengan input API yang tidak boleh memiliki feedLabel dan Kolom contentLanguage ditetapkan. Jenis sumber data ini tidak didukung untuk input file.

Membuat sumber data tambahan dan menautkannya ke sumber data utama

Sumber data tambahan hanya digunakan untuk memperbarui data produk yang sudah ada di satu atau beberapa sumber data utama. Anda dapat memiliki beberapa sumber data, dan masing-masing dapat melengkapi data dalam sejumlah data utama sumber.

Anda dapat menggunakan sumber data tambahan untuk melakukan pembaruan sebagian pada data produk dengan menambahkan ID unik sumber data sebagai parameter kueri saat melakukan panggilan ke metode accounts.productInputs.insert dan accounts.productInputs.delete. Anda hanya dapat menggunakan sumber data tambahan untuk memperbarui produk yang 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 harus memiliki feedLabel dan contentLanguage {i>field <i}telah disetel. Sumber data API tambahan harus selalu memiliki feedLabel dan contentLanguage kolom tidak disetel.

Menyiapkan jadwal untuk sumber data file

Untuk menyiapkan jadwal feed file, konfigurasikan sumber data Anda menjadi sumber data file 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 metode accounts.dataSources.fetch. Metode ini langsung melakukan pengambilan data di 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 metode accounts.dataSources.get.

Daftar sumber data

Untuk mencantumkan konfigurasi sumber data untuk akun Anda, gunakan metode accounts.dataSources.list.

Mem-patch sumber data

Untuk memperbarui konfigurasi sumber data yang ada, gunakan accounts.dataSources.patch .

Sumber data produk utama memungkinkan Anda mengelola aturan default sumber data. Aturan default adalah aturan yang berlaku untuk semua dalam sumber data Anda. Aturan default dapat ditetapkan saat membuat sumber data atau dengan memperbarui sumber data yang ada melalui kolom aturan default.

Contoh konfigurasi berikut memastikan bahwa semua atribut pertama kali diambil dari sumber data dengan ID unik 1001. Kemudian, atribut yang tidak ada akan ditambahkan dari sumber data utama. Pada akhirnya, atribut yang tersisa akan diambil dari sumber data tambahan dengan ID unik 1002 jika belum disediakan di sumber data lainnya. Jika atribut yang sama disediakan di beberapa sumber data, nilai yang lebih tinggi dalam daftar akan dipilih.

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

Pengelolaan feed otomatis

Untuk mendaftarkan akun Anda guna pengelolaan sumber data otomatis, Anda harus melakukan hal berikut:

Setelah akun Anda memenuhi syarat untuk pendaftaran, Anda dapat menggunakan metode accounts.autofeedSettings.updateAutofeedSettings untuk mengaktifkan pengelolaan sumber data secara otomatis. Mengaktifkan otomatis memungkinkan Google menambahkan produk Anda secara otomatis dari toko online Anda dan memastikannya selalu diperbarui di platform Google.

Mengambil status upload file

Untuk mendapatkan status sumber data dengan file, pengambilan, atau spreadsheet, Anda dapat memanggil metode GET dari layanan accounts.dataSources.fileUploads. Untuk mendapatkan hasil pengambilan terakhir sumber data yang dihitung secara asinkron saat pemrosesan sumber data 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.