Ringkasan API sumber Data Penjual

Halaman ini menunjukkan cara membuat dan memperbarui sumber data secara terprogram yang memungkinkan Anda menyisipkan produk. Sumber data otomatis memudahkan pengiriman data produk Anda ke Google. Sumber data otomatis memastikan bahwa informasi terbaru tentang produk relevan dari situs Anda diterima Google.

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

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 dan contentLanguage spesifik.
  • Buat sumber data karakter pengganti. Sumber data karakter pengganti tidak memiliki kolom feedLabel dan contentLanguage yang ditetapkan. Sumber data karakter pengganti memungkinkan Anda menyisipkan produk dengan berbagai kombinasi feedLabel dan contentLanguage ke dalam sumber data.
  • Buat sumber data tambahan untuk ditautkan ke sumber data utama yang ada.
  • Siapkan jadwal untuk sumber data file.
  • Mengelola sumber data API.
  • Gunakan jenis sumber data lain seperti promosi.

Prasyarat

  • Akun Anda harus sudah dimigrasikan ke feed lokalitas tunggal.

  • Untuk memverifikasi bahwa akun tersebut telah dimigrasikan ke pemisahan target data, gunakan daftar sumber data atau metode get. Jika tidak memenuhi syarat, Anda akan menerima pesan pengecualian berikut dan 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

Untuk membuat sumber data utama baru dengan feedLabel dan contentLanguage tertentu, tetapkan kolom feedLabel dan contentLanguage dalam konfigurasi khusus jenis. 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 serta jangan tetapkan kolom feedLabel dan contentLanguage.

Saat 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 dapat berupa karakter pengganti.

Hanya sumber data dengan input API yang dapat menjadi sumber data karakter pengganti. Sumber 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 metode accounts.productInputs.insert dan accounts.productInputs.delete. Anda hanya dapat menggunakan sumber data tambahan untuk memperbarui produk yang sudah ada.

Untuk membuat sumber data tambahan, konfigurasikan sumber data Anda menggunakan SupplementalProductDataSource, lalu tautkan dengan memperbarui kolom defaultRule di sumber data utama Anda.

Sumber data file tambahan tidak boleh merupakan sumber data karakter pengganti. Sumber data API tambahan harus selalu berupa sumber data karakter pengganti.

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 metode accounts.dataSources.delete.

Mengambil sumber data

Untuk mengambil file yang dikonfigurasi di sumber data, gunakan metode 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 metode accounts.dataSources.get.

Daftar sumber data

Untuk menampilkan daftar konfigurasi sumber data bagi akun Anda, gunakan metode accounts.dataSources.list.

Mem-patch sumber data

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