Halaman ini diterjemahkan oleh Cloud Translation API.

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 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 tertentu.
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 menyisipkan 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 telah 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 inventaris Merchant Center Anda. Anda hanya dapat menambahkan atau menghapus produk menggunakan sumber data utama. Jika setiap produk yang ditambahkan ke sumber data utama memenuhi persyaratan data dan kelayakan Merchant Center, 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.

Contoh permintaan berikut menunjukkan cara membuat sumber data produk utama:

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources

{
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "feedLabel": "{FEED_LABEL}",
    "countries": [
      "{COUNTRY}"
    ],
    "channel": "ONLINE_PRODUCTS"
  }
}

Ganti kode berikut:

{ACCOUNT_ID}: ID unik akun Merchant Center Anda.
{DISPLAY_NAME}: Nama tampilan sumber data.
{CONTENT_LANGUAGE}: Kode bahasa ISO 639-1 dua huruf dari produk di sumber data.
{FEED_LABEL}: Label feed sumber data.
{COUNTRY}: Kode wilayah CLDR dari negara target produk yang akan diupload menggunakan sumber data.

Setelah permintaan berhasil dijalankan, Anda akan melihat respons berikut:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATA_SOURCE_ID}",
  "dataSourceId": "{DATA_SOURCE_ID}",
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "{FEED_LABEL}",
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "countries": [
      "{COUNTRY}"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

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

Untuk melihat sumber data yang baru dibuat, gunakan metode 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 Merchant, Anda dapat memiliki beberapa sumber data API, beberapa di antaranya dapat tanpa menetapkan kolom feedLabel dan contentLanguage.

Hanya sumber data dengan input API yang dapat tanpa menetapkan kolom feedLabel dan contentLanguage. 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 tambahan, dan masing-masing dapat melengkapi data di sejumlah sumber data utama.

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, konfigurasikan sumber data menggunakan SupplementalProductDataSource, lalu tautkan dengan memperbarui kolom defaultRule di sumber data utama Anda.

Sumber data file tambahan harus menetapkan kolom feedLabel dan contentLanguage. Sumber data API tambahan harus selalu memiliki kolom feedLabel dan contentLanguage yang tidak ditetapkan.

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 Anda, gunakan metode 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.

Mencantumkan sumber data

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

Sumber data patch

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

Menautkan sumber data

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

Untuk informasi selengkapnya tentang cara menyiapkan aturan, lihat Menyiapkan aturan untuk sumber data produk Anda.

Contoh konfigurasi berikut memastikan bahwa semua atribut diambil terlebih dahulu 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 lain. 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 otomatis feed

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

Periksa apakah akun Anda memenuhi syarat untuk pendaftaran dengan memanggil metode accounts.autofeedSettings.getAutofeedSettings.
Pastikan akun Anda bukan akun marketplace.

Setelah akun Anda memenuhi syarat untuk pendaftaran, Anda dapat menggunakan metode accounts.autofeedSettings.updateAutofeedSettings untuk mengaktifkan pengelolaan sumber data secara otomatis. Dengan mengaktifkan pengelolaan sumber data secara otomatis, Google dapat otomatis menambahkan produk Anda dari toko online dan memastikan produk tersebut 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/{ACCOUNT_ID}/datasources/{DATASOURCE_ID}/fileUploads/latest

Status upload file mungkin berisi tampilan mendetail tentang produk Anda, termasuk masalah potensial.

Perhatikan bahwa status upload file mungkin tidak ada jika file tidak pernah diupload. Status upload file mungkin dalam status sedang diproses jika diminta segera setelah file diupload.