Mulai menggunakan Layanan Perbandingan Belanja (CSS)

Melakukan operasi dasar dengan API adalah cara yang baik untuk mulai menggunakannya.

Prasyarat

Sebelum Anda memulai, selesaikan hal-hal berikut:

  • Pastikan Anda memiliki akun CSS Center yang valid.
  • Mendaftarkan developer API.
  • Verifikasi kebenaran penyiapan izin Anda.
  • Pastikan Anda telah mengaktifkan CSS API.
  • Pastikan Anda telah menginstal library klien untuk lingkungan Anda.

Untuk mengetahui informasi selengkapnya, lihat Panduan memulai.

Aktifkan CSS API

Untuk mendaftar sebagai developer guna menggunakan CSS API, Anda harus menautkan akun CSS Center dan project Google Cloud menggunakan metode Pendaftaran Developer, sebagai berikut:

Tautkan CSS Center dan project Google Cloud Anda: Penautan dilakukan secara otomatis, karena pemanggil memiliki akses ke project Google Cloud berdasarkan Token akses atau Kunci API, dan merupakan pengguna yang diberi otorisasi untuk akun CSS Center.

Mendaftarkan developer API

Menambahkan pengguna developer API ke akun Pusat CSS: Jika pengguna sudah ada, mereka hanya akan diberi jenis akses "Developer API" yang baru. Jika pengguna baru, dia akan menerima undangan email CSS Center.

Setelah pendaftaran, Anda dapat melihat status Pendaftaran menggunakan GetDeveloperRegistration atau membatalkan pendaftaran menggunakan UnregisterGCP. Anda dapat menggunakan panggilan pendaftaran berikut:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
      developer_email:"example-email@example.com"
}

Setelah permintaan berhasil dijalankan, harapkan respons:

{
      "developerRegistration":
{
            "name": "accounts/ACCOUNT_ID/developerRegistration",
           "gcpIds": [
            "GOOGLE_CLOUD_PROJECT_ID"
        ]
    }
}

Produk CSS

Mirip dengan sub-API Produk, CSS API membedakan antara CssProductInput dan ListCssProduct. Sisipkan produk dengan InsertCssProductInput.

Setelah sistem internal kami memproses produk (hal ini dapat memerlukan waktu beberapa menit), ambil produk dengan ListCssProducts.

Identifikasi produk Anda menggunakan raw_provided_id. Sebaiknya gunakan ID yang sudah Anda gunakan di sistem Anda sendiri. Atau, metode umum untuk membuatnya mencakup penggunaan salah satu hal berikut:

  • ID Unik Global (GUID)
  • ID Unik Universal (UUID)
  • Atribut produk unik yang digabungkan (misalnya, brand_model_color_size)

Untuk mengetahui informasi selengkapnya, lihat Menyisipkan/Mencantumkan/Memperbarui/Menghapus produk.

Operasi dasar

Berikut beberapa permintaan dasar yang dapat Anda coba.

  1. Sisipkan produk uji menggunakan InsertCssProductInput. Untuk mendapatkan bantuan terkait atribut yang akan dikirim, tinjau contoh kode ini.

  2. Cantumkan semua produk Anda menggunakan ListCssProducts. Perhatikan bahwa ada sedikit penundaan pemrosesan antara penyisipan produk dan penampilannya untuk listingan. Jika Anda tidak langsung melihatnya, coba lagi setelah beberapa detik.

  3. Perbarui satu produk menggunakan UpdateCssProductInput menggunakan cssproductinput.name Anda. Anda hanya perlu mengirimkan atribut yang perlu diperbarui. Untuk melihat contoh, lihat kode contoh.

  4. Hapus produk pengujian menggunakan DeleteCssProductInpu, dengan memberikan raw_provided_id.

Batasan

Memasukkan atau menghapus produk satu per satu dapat berjalan lambat. Untuk meningkatkan performa, Gunakan Asinkron untuk meningkatkan performa. Hal ini memungkinkan pemanggilan API secara paralel.

Mencantumkan dan memberi label akun Anda

Pengelolaan Label di CSS API memungkinkan Anda mengatur akun Merchant Center klien secara terprogram menggunakan tag kustom. Fitur ini membantu Anda mengategorikan klien secara efisien (misalnya, menurut jenis atau strategi), sehingga memungkinkan organisasi yang lebih baik dan operasi yang lebih lancar. Anda dapat menggunakan API untuk melakukan fungsi berikut pada label: