Halaman ini menjelaskan cara membuat akun Merchant Center dan mengupload contoh produk menggunakan Merchant API.
Sebelum memulai
Aktifkan Merchant API di project Google Cloud Anda.
Buat akun
Untuk menggunakan Merchant API, Anda harus memiliki akun Merchant Center. Untuk membuat akun Merchant Center, lihat Memulai Merchant Center.
Mendapatkan ID akun
Anda bisa mendapatkan ID akun menggunakan metode
accounts.list.
Anda dapat menggunakan Google APIs Explorer untuk menjalankan permintaan Merchant API. APIs Explorer menggunakan Google OAuth 2.0 untuk autentikasi. Sebelum menjalankan permintaan, pastikan kotak centang Google OAuth 2.0 dicentang.
Untuk melakukan autentikasi menggunakan OAuth 2.0, Anda harus login ke Akun Google Anda, lalu login ke API Explorer. Anda juga perlu mengizinkan API Explorer untuk mengelola listingan dan akun produk Anda.
Permintaan berikut menunjukkan cara mengambil ID akun Anda:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
Setelah permintaan berhasil berjalan, Anda akan melihat respons berikut:
{
"accounts": [
{
"name": "{ACCOUNT_NAME}",
"accountId": "{ACCOUNT_ID}",
"accountName": "{ACCOUNT_DISPLAY_NAME}",
"timeZone": {
"id": "America/Los_Angeles"
},
"languageCode": "en-US"
}
]
}
Salin {ACCOUNT_ID} karena Anda akan memerlukannya untuk menjalankan permintaan lain.
Membuat sumber data produk utama
Untuk menyisipkan produk, Anda memerlukan sumber data produk utama. Permintaan berikut menunjukkan cara membuat sumber data yang dapat Anda gunakan untuk menyisipkan produk ke akun Anda:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1
{
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"contentLanguage": "en",
"countries": [
"US"
],
"feedLabel": "US"
},
"name": "primary-data-source",
"displayName": "Primary Products Data Source"
}
Ganti {ACCOUNT_ID} dengan ID akun Merchant Center yang Anda buat.
Setelah permintaan ini berhasil dijalankan, Anda akan melihat respons berikut:
{
"name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
"dataSourceId": "{DATASOURCE_ID}",
"displayName": "Primary Products Data Source",
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"feedLabel": "US",
"contentLanguage": "en",
"countries": [
"US"
],
"defaultRule": {
"takeFromDataSources": [
{
"self": true
}
]
}
},
"input": "API"
}
Salin nilai kolom name karena Anda akan memerlukannya untuk menyisipkan
produk.
Diperlukan waktu beberapa menit agar sumber data yang dibuat tersedia untuk menyisipkan produk.
Anda dapat melihat sumber data ini di UI Merchant Center. Untuk informasi selengkapnya, lihat Cara menemukan tab Sumber data.
Masukkan produk
Untuk menyisipkan contoh produk ke akun Anda, jalankan permintaan berikut:
POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1
{
"channel": "ONLINE",
"contentLanguage": "en",
"feedLabel": "US",
"name": "Red T-shirt",
"attributes": {
"gender": "Male",
"brand": "New brand"
},
"offerId": "tshirt-123"
}
Ganti {DATASOURCE_NAME} dengan nilai yang Anda salin sebelumnya.
Setelah permintaan ini berhasil dijalankan, Anda akan melihat respons berikut:
{
"name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
"product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
"channel": "ONLINE",
"offerId": "tshirt-123",
"contentLanguage": "en",
"feedLabel": "US",
"attributes": {
"brand": "New brand",
"gender": "Male"
}
}
ID produk untuk produk yang baru dibuat adalah online~en~US~tshirt-123. Anda
dapat menggunakan
metode
accounts.products.get untuk mengambil detail tentang produk ini. Anda juga dapat menggunakan UI Merchant
Center untuk melihat produk
ini.