Halaman ini menjelaskan cara membuat akun Merchant Center dan mengupload produk contoh menggunakan Merchant API.
Sebelum memulai
Aktifkan Merchant API di project Google Cloud Anda.
Jika integrasi API digunakan di AppScript menggunakan Shopping Content Service, project Google Cloud default akan dibuat dan layanan Merchant API diaktifkan secara otomatis. Namun, Anda tetap harus menyelesaikan pendaftaran Developer satu kali sebelum menggunakan Merchant API. Untuk mengetahui informasi selengkapnya, lihat Menggunakan Layanan Merchant API di Apps Script.
Buat akun
Untuk menggunakan Merchant API, Anda harus memiliki akun Merchant Center. Untuk membuat akun Merchant Center, lihat Mulai menggunakan Merchant Center.
Daftarkan diri sebagai pengembang
Untuk menggunakan Merchant API, Anda harus menautkan akun Merchant Center dan project Google Cloud menggunakan metode Pendaftaran Developer, sebagai berikut:
Tautkan Merchant Center dan project Google Cloud Anda: Penautan disetujui secara otomatis, karena pemanggil memiliki Token Akses atau Kunci API yang valid dari project Google Cloud , dan merupakan pengguna yang diberi otorisasi untuk akun Merchant Center.
Menambahkan pengguna Developer API ke akun Merchant Center: API pendaftaran menambahkan pengguna Developer API ke akun Merchant Center. Jika pengguna sudah ada, pengguna tersebut akan diberi Jenis Akses baru. Jika pengguna baru, dia akan menerima undangan email Merchant Center.
Sebaiknya gunakan metode accounts.users.create
untuk menambahkan developer API tambahan atau cadangan guna memverifikasi bahwa jika orang tersebut keluar dari organisasi Anda atau dihapus, Anda tetap dapat memiliki pendaftaran developer yang valid.
Setelah pendaftaran, Anda dapat melihat Status pendaftaran menggunakan
GetDeveloperRegistration atau membatalkan pendaftaran menggunakan UnregisterGCP.
Panggilan pendaftaran adalah
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp
{
developer_email:"example-email@example.com"
}
Setelah permintaan berhasil dijalankan, harapkan respons:
{
"developerRegistration": {
"name": "accounts/ACCOUNT_ID/developerRegistration",
"gcpIds": ["GOOGLE_CLOUD_PROJECT_ID"]
}
}
Setelah developer API terdaftar, Anda dapat menggunakan metode
accounts.users.patch
untuk memberikan peran tambahan kepada mereka, seperti STANDARD dan ADMIN.
Mendapatkan ID akun Anda
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 Google OAuth 2.0 dicentang.
Untuk melakukan autentikasi menggunakan OAuth 2.0, Anda harus login ke Akun Google Anda, lalu login ke APIs Explorer. Anda juga perlu mengizinkan APIs Explorer untuk mengelola listingan produk dan akun Anda.
Permintaan berikut menunjukkan cara mengambil ID akun Anda:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
atau
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}
Setelah permintaan berhasil dijalankan, 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 mengetahui informasi selengkapnya, lihat Cara menemukan tab Sumber data.
Masukkan produk
Untuk memasukkan produk contoh 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.