Mulai menggunakan Merchant API

Aktifkan Merchant API di project Cloud untuk memulai.

Berikut cara menggunakan Merchant API:

Menggunakan library klien

Merchant API terdiri dari beberapa sub-API.

Setiap sub-API memiliki contoh kode dan library klien untuk membantu Anda memulai.

Jika Anda sudah menggunakan Content API for Shopping, lihat kompatibilitas Content API for Shopping.

Kirim permintaan

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

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

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

Catatan: Bagian :{METHOD} dihilangkan untuk metode standar.

Misalnya, permintaan ini akan menghapus inventaris regional:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/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, berikut cara membuat region baru untuk account/123

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions

Lihat dokumentasi referensi Merchant API untuk mengetahui detail selengkapnya tentang layanan tertentu.

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.

Catatan: Jika Anda menggunakan library klien, mekanisme transpor default-nya adalah gRPC. Dalam sebagian besar kasus, Anda tidak perlu melakukan apa pun selain memanggil endpoint Merchant API untuk menggunakan gRPC.

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: Gunakan tombol Masalah baru di GitHub.

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