Anda dapat menggunakan panduan ini untuk mengintegrasikan Merchant API dengan penerapan Content API for Shopping yang sudah ada.
Mulai
Lihat desain API Penjual untuk mengetahui detail tentang Merchant API, dan sub-API-nya.
Untuk mulai menggunakan Merchant API, ubah URL permintaan Anda ke format berikut:
https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…
Lihat panduan memulai dan referensi Merchant API untuk mendapatkan informasi lebih lanjut.
Dukungan gRPC
Merchant API mendukung gRPC dan REST. Anda dapat menggunakan gRPC untuk Merchant API dan REST untuk Content API for Shopping secara bersamaan.
Library klien Merchant API memerlukan gRPC.
Lihat menggunakan gRPC untuk mengetahui informasi selengkapnya.
Kompatibilitas
Panduan ini menjelaskan perubahan umum yang berlaku untuk seluruh Merchant API. Lihat panduan berikut untuk mengetahui perubahan pada fitur tertentu:
- Memigrasikan pengelolaan akun
- Memigrasikan setelan pengiriman
- Memigrasikan pengelolaan produk
- Memigrasikan pengelolaan sumber data
- Memigrasikan pengelolaan inventaris
- Memigrasikan pengelolaan promosi
- Memigrasikan pengelolaan pelaporan
- Memigrasikan pengelolaan sumber konversi
- Memigrasikan pengelolaan kemitraan feed lokal
Merchant API dirancang untuk berfungsi bersama dengan fitur Content API for Shopping v2.1 yang sudah ada.
Misalnya, Anda dapat menggunakan Merchant Inventories API bersama inventaris
Content API for Shopping v2.1 yang sudah ada dan
penerapan products
. Anda
dapat menggunakan Content API for Shopping untuk mengupload produk
lokal baru (yang Anda jual
di toko lokal), lalu menggunakan resource Merchant Inventories API
LocalInventory
untuk mengelola informasi di toko untuk produk tersebut.
Permintaan batch
Merchant API tidak mendukung metode customBatch
yang ditampilkan di
Content API for Shopping. Sebagai gantinya, lihat Mengirim permintaan batch. Jika Anda menggunakan customBatch
, dan memerlukan fitur ini untuk Merchant API, beri tahu kami alasannya di masukan Anda.
ID
Agar selaras dengan prinsip peningkatan API Google, kami telah membuat beberapa perubahan pada ID untuk resource Merchant API.
nama menggantikan Id
Semua resource Merchant API menggunakan kolom name
sebagai ID uniknya.
Berikut adalah contoh cara menggunakan kolom name
dalam panggilan Anda:
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert
Kolom name
baru ini ditampilkan sebagai ID resource untuk semua panggilan baca dan tulis di Merchant API.
Nilai yang ditampilkan di kolom name
menggunakan format ID baru.
Misalnya, implementasikan metode getName()
untuk mengambil name
dari
resource dan simpan output sebagai variabel, bukan membuat name
dari ID penjual dan resource sendiri.
Format ID baru
Di Merchant API, ID resource menggunakan format berikut:
channel~language~feedLabel~offerId
Resource Content API menggunakan :
, bukan ~
, di antara setiap nilai dalam ID:
channel:language:feedLabel:offerId
Semua panggilan Merchant API menampilkan format baru dengan ~
di antara nilai ID. Sebaiknya simpan format baru dari respons dan gunakan dalam
panggilan mendatang.
kolom induk untuk resource turunan
Di Merchant API, semua resource turunan memiliki kolom parent
. Anda dapat menggunakan
kolom parent
untuk menentukan name
resource yang akan menjadi tujuan penyisipan turunan,
bukan meneruskan seluruh resource induk. Anda juga dapat menggunakan kolom parent
dengan metode list
untuk mencantumkan resource turunan dari parent
tersebut.
Misalnya, untuk mencantumkan inventaris lokal bagi produk tertentu, tentukan
name
produk di kolom
parent
untuk
metode
list
. Dalam hal ini, product
yang diberikan adalah parent
dari
resource LocalInventory
yang ditampilkan.
Jenis
Berikut adalah beberapa jenis umum yang dibagikan di seluruh sub-API Merchant API.
Harga
Berikut ini yang diubah untuk Price
dalam paket Merchant Common:
Content API | API Penjual | |
---|---|---|
Kolom jumlah | value:string |
amountMicros:int64 |
Kolom mata uang | currency:string
|
currencyCode:string |
Jumlah Price
kini dicatat dalam mikro, yang mana 1 juta mikro
setara dengan unit standar mata uang Anda.
Di Content API for Shopping, Price
adalah angka desimal dalam bentuk
string.
Nama kolom jumlah telah diubah dari value
menjadi amountMicros
Nama kolom mata uang telah diubah dari currency
menjadi currencyCode
. Formatnya tetap ISO 4217.