Halaman ini diterjemahkan oleh Cloud Translation API.

Ringkasan Merchant API

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

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

Pengelolaan akun otomatis
Pengelolaan produk otomatis
Pengelolaan inventaris otomatis
Pelaporan kustom

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

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

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 Anda tidak perlu melakukan pengambilan data secara berkala karena Anda akan diberi tahu saat status produk berubah.
Memperkenalkan resource accounts.autofeedSettings dan metode untuk mengambil dan memperbarui setelan feed otomatis.
Memperkenalkan upload ulasan produk dan ulasan penjual.
Menyederhanakan resource accounts.products dengan pengenalan 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 terisolasi dan lebih sering.
Penyelarasan yang lebih baik dengan proposal peningkatan API Google.
Memperbarui dokumentasi dan contoh kode.
Peningkatan dukungan dan komunikasi untuk developer melalui Pendaftaran Developer.

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: Akun ini adalah akun yang akan Anda kueri, perbarui, dan upload datanya. 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.
Tautkan akun Merchant Center Anda ke project Google Cloud dengan memanggil metode Pendaftaran Developer. Pengguna akun tertaut akan menerima komunikasi API, termasuk pengumuman layanan wajib, survei developer, dan peluang.

Autentikasi dengan Merchant API

Anda dapat menggunakan opsi berikut untuk autentikasi:

Anda dapat membuat client ID dan rahasia OAuth 2.0 untuk aplikasi Anda. ID dan rahasia 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 menghapus inventaris regional:

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

Untuk membuat resource, 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 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 produk contoh, lihat Mulai menggunakan Merchant API.

Menggunakan gRPC atau REST

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

gRPC (direkomendasikan)	REST
Buat isi permintaan sebagai buffer protokol. Kirim isi permintaan ke server dengan HTTP/2. Lakukan deserialisasi respons ke buffer 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 mengetahui informasi tentang cara mendapatkan dukungan, lihat Mendapatkan bantuan terkait Merchant API.

Beri masukan

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

Fitur API: Kirimkan formulir masukan
Dokumentasi: Gunakan rating jempol di 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 mengetahui informasi tentang kompatibilitas mundur, lihat Kompatibilitas Content API for Shopping.
Untuk mengetahui lebih lanjut fitur utama Merchant API, lihat panduan di menu navigasi kiri.
Untuk mengetahui informasi tentang resource dan layanan yang tersedia, lihat Dokumentasi referensi.