Merchant API v1beta dihentikan dan ditutup pada 28 Februari 2026. Untuk mengetahui langkah-langkah transisi ke versi stabil terbaru, lihat Bermigrasi dari v1beta ke v1.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Ringkasan Merchant API

Anda dapat menggunakan Merchant API untuk

Mengelola tampilan bisnis dan produk Anda di Google.
Mendapatkan akses terprogram ke data, insight, dan kemampuan unik.
Mengembangkan bisnis dan menjangkau lebih banyak pelanggan di Google.

Merchant API dapat mengelola akun Merchant Center yang besar atau rumit. Kasus penggunaan umum mencakup:

Pengelolaan akun otomatis
Pengelolaan produk otomatis
Pengelolaan inventaris otomatis
Pengelolaan laporan otomatis tentang performa dan insight pasar

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 juga memungkinkan Anda menjalankan beberapa permintaan individual secara paralel.

Merchant API adalah desain ulang dari 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.
Memungkinkan notifikasi untuk perubahan pada data produk Anda, sehingga tidak perlu pengambilan data berkala dengan memberi tahu Anda saat status produk berubah.
Memperkenalkan accounts.autofeedSettings resource dan metode untuk mengambil dan memperbarui setelan feed otomatis.
Memperkenalkan upload ulasan produk dan ulasan penjual.
Memperkenalkan accounts.productInputs resource untuk menyederhanakan accounts.products resource.
Memungkinkan pembaruan data produk bersamaan 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
Dokumentasi dan contoh kode yang diperbarui
Penyelarasan yang lebih baik dengan proposal peningkatan API Google
Dukungan dan komunikasi yang ditingkatkan untuk developer melalui Pendaftaran Developer.

Sebelum memulai

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

Akun Merchant Center: Akun inilah 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: Gunakan project ini untuk mendapatkan akses API ke akun Anda.
Link dari akun Merchant Center Anda ke project Google Cloud. Buat link dengan memanggil metode Pendaftaran Developer. Anda akan menggunakan akun dan pengguna ini untuk komunikasi terkait integrasi API, survei, dan peluang.

Tautkan akun Merchant Center Anda ke project Google Cloud dengan mendaftar sebagai developer. Pengguna dengan peran developer API akan menerima komunikasi API, termasuk email pengumuman layanan, 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.

Kode akun dan produk

Merchant API menggunakan nama resource, bukan ID untuk identifikasi. Contoh nama resource untuk produk dapat berupa accounts/123456/products/en~US~sku123, dengan 123456 adalah kode unik akun dan en~US~sku123 adalah kode 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 daftar dan dapatkan.

Misalnya, permintaan berikut akan menghapus inventaris regional:

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

Untuk membuat resource, gunakan nama resource dari resource induk dan URL ini:

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

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

POST https://merchantapi.googleapis.com/accounts/v1/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 buffer protokol. Kirim isi permintaan ke server dengan HTTP/2. Lakukan deserialisasi respons ke buffer protokol. Interpretasi hasil.	Buat isi permintaan sebagai objek JSON. Kirim ke server menggunakan HTTP 1.1. Lakukan deserialisasi respons sebagai objek JSON. Interpretasi hasil.

Menggunakan library klien dan contoh kode

Setiap sub-API memiliki library klien untuk membantu Anda memulai. Contoh kode dapat membantu Anda memulai penulisan 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

Untuk memberikan masukan, kirim salah satu hal berikut:

Fitur API: Pilih opsi Kirim Masukan di bagian Apa Masalah/Pertanyaan? pada formulir masukan.
Dokumentasi: Gunakan rating jempol di halaman dan tombol Kirim masukan.
Contoh dan library: Buat masalah di repositori GitHub untuk contoh kode.

Langkah berikutnya

Untuk mengetahui informasi tentang kompatibilitas mundur, 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.

Berikutnya

Terms and Conditions