Halaman ini diterjemahkan oleh Cloud Translation API.

Ringkasan Merchant API

Halaman ini memberikan pengantar tentang Merchant API dan menjelaskan cara menggunakannya untuk mengotomatiskan berbagai alur kerja yang terkait dengan pengelolaan akun, produk, dan inventaris di Merchant Center.

Anda dapat menggunakan Merchant API untuk menjangkau lebih banyak pelanggan dan menampilkan produk Anda di seluruh Google. Anda dapat menggunakan Merchant API untuk mengelola akun Merchant Center yang besar atau rumit. Beberapa kasus penggunaan umum antara lain sebagai berikut:

Pengelolaan akun otomatis
Pengelolaan produk otomatis
Pengelolaan inventaris otomatis
Pelaporan kustom

Merchant API memungkinkan Anda membuat dan mengelola beberapa sumber data, sehingga informasi tentang produk, promosi, dan ulasan dapat diatur dengan lebih baik. Dengan Merchant API, Anda dapat mengelola produk dengan cara yang melengkapi metode upload data produk lainnya seperti file dan feed otomatis.

Merchant API adalah desain ulang dari Content API for Shopping, dan terdiri dari beberapa sub-API.

Retailer bertanggung jawab untuk mematuhi kebijakan iklan Shopping dan listingan gratis. Google Shopping berhak menerapkan kebijakan ini dan merespons dengan tepat jika kami menemukan konten atau perilaku yang melanggar kebijakan ini.

Yang baru di Merchant API

Berikut beberapa alasan untuk mengupgrade ke Merchant API:

Pengelolaan data inventaris yang lebih baik dengan diperkenalkannya metode baru berikut:
Memungkinkan pengelolaan sumber data tambahan melalui pembuatan dan pengambilan sumber data tambahan, serta dengan menautkan sumber data tambahan ke sumber data utama.
Mengaktifkan notifikasi untuk perubahan pada data produk Anda, sehingga tidak perlu mengambil data secara berkala dengan memberi tahu Anda saat status produk berubah.
Memperkenalkan resource dan metode accounts.autofeedSettings untuk mengambil dan memperbarui setelan feed otomatis.
Memperkenalkan upload ulasan produk dan ulasan merchant.
Menyederhanakan resource accounts.products dengan memperkenalkan resource accounts.productInputs.
Memungkinkan pembaruan data produk bersama dengan metode upload data lainnya seperti file.
Tabel NonProductPerformanceView baru untuk data performa non-produk, seperti informasi tentang traffic masuk ke situs retailer.
Desain modular dengan peningkatan fitur yang lebih sering dan terisolasi.
Peningkatan kesesuaian dengan proposal peningkatan API Google.
Memperbarui dokumentasi dan contoh kode.

Untuk mengetahui informasi selengkapnya, lihat Fitur baru yang diperkenalkan di Merchant API Beta.

Sebelum memulai

Untuk menjalankan permintaan Merchant API, Anda harus memiliki hal berikut:

Akun Merchant Center: Ini adalah akun tempat Anda akan membuat kueri, memperbarui, dan mengupload data. Pastikan Anda memiliki izin yang diperlukan untuk mengelola produk dan inventaris di akun ini.
Project Google Cloud: Project ini digunakan untuk mendapatkan akses API ke akun Anda.

Autentikasi dengan Merchant API

Anda dapat menggunakan opsi berikut untuk autentikasi:

Anda dapat membuat client ID dan secret OAuth 2.0 untuk aplikasi Anda. ID dan secret tersebut kemudian dapat digunakan untuk membuat kredensial OAuth 2.0 yang diperlukan dalam panggilan API ke akun Merchant Center.
Anda dapat membuat akun layanan dan mendownload kunci pribadinya untuk melakukan panggilan API.

ID akun dan produk

Merchant API menggunakan nama resource, bukan ID untuk identifikasi. Contoh nama resource untuk produk dapat berupa accounts/123456/products/online~en~US~sku123, dengan 123456 adalah ID unik akun dan online~en~US~sku123 adalah ID unik produk.

Format URL permintaan

Untuk mengoperasikan resource, kirim permintaan ke URL dalam format berikut:

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

Bagian :{METHOD} dihilangkan untuk metode standar seperti list dan get.

Misalnya, permintaan berikut akan menghapus inventaris regional:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123456/products/online~en~US~sku123/regionalInventories/456

Untuk membuat resource baru, Anda dapat menggunakan nama resource dari resource induk dan URL berikut:

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

Misalnya, permintaan berikut menunjukkan cara membuat region baru untuk accounts/123456:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

Untuk mengetahui detail selengkapnya tentang layanan tertentu, lihat dokumentasi referensi Merchant API.

Mulai menggunakan Merchant API

Untuk melihat cara kerja Merchant API dengan cepat dan mencoba mengupload contoh produk, lihat Memulai Merchant API.

Menggunakan gRPC atau REST

Merchant API mendukung gRPC dan REST. Berikut dua cara untuk melakukan panggilan Merchant API:

gRPC (direkomendasikan)	REST
Buat isi permintaan sebagai buffering protokol. Kirim isi permintaan ke server dengan HTTP/2. Lakukan deserialisasi respons ke buffering protokol. Menginterpretasi hasil.	Buat isi permintaan sebagai objek JSON. Kirim ke server menggunakan HTTP 1.1. Deserialisasi respons sebagai objek JSON. Menginterpretasi hasil.

Menggunakan library klien dan contoh kode

Setiap sub-API memiliki library klien untuk membantu Anda memulai. Contoh kode dapat membantu Anda mulai menulis kode di Java, PHP, dan Python. Untuk mengetahui informasi selengkapnya, lihat Contoh untuk Merchant API.

Dapatkan bantuan

Untuk informasi tentang cara mendapatkan dukungan, lihat Mendapatkan bantuan terkait Merchant API.

Beri masukan

Periode beta memberi kami kesempatan untuk mengumpulkan dan menindaklanjuti masukan Anda sebelum rilis ketersediaan umum. Untuk memberikan masukan, kirimkan salah satu hal berikut:

Fitur API: Mengirimkan formulir masukan
Dokumentasi: Gunakan rating jempol dalam halaman dan tombol Kirim masukan.
Contoh dan library: Buat masalah di repositori GitHub untuk contoh kode.

Untuk memberikan masukan umum setelah menerapkan setiap tugas, gunakan formulir masukan.

Langkah berikutnya

Untuk informasi tentang kompatibilitas mundur, lihat kompatibilitas Content API for Shopping.
Untuk mengetahui lebih lanjut fitur utama Merchant API, lihat panduan di menu navigasi sebelah kiri.
Untuk informasi tentang resource dan layanan yang tersedia, lihat Dokumentasi referensi.

Berikutnya

Desain