หน้านี้จะอธิบายวิธีสร้างบัญชี Merchant Center และอัปโหลดตัวอย่างผลิตภัณฑ์โดยใช้ Merchant API
ก่อนเริ่มต้น
เปิดใช้ Merchant API ในโปรเจ็กต์ Google Cloud
หากใช้การผสานรวม API ใน AppScript โดยใช้บริการเนื้อหา Shopping ระบบจะสร้างโปรเจ็กต์ Google Cloud เริ่มต้นและเปิดใช้บริการ Merchant API โดยอัตโนมัติ อย่างไรก็ตาม คุณยังคงต้องลงทะเบียนนักพัฒนาแอปแบบครั้งเดียวก่อนจึงจะใช้ Merchant API ได้
สร้างบัญชี
หากต้องการใช้ Merchant API คุณต้องมีบัญชี Merchant Center หากต้องการสร้างบัญชี Merchant Center โปรดดูเริ่มต้นใช้งาน Merchant Center
ลงทะเบียนในฐานะนักพัฒนาซอฟต์แวร์
หากต้องการใช้ Merchant API คุณต้องลิงก์บัญชี Merchant Center กับโปรเจ็กต์ Google Cloud โดยใช้วิธีการลงทะเบียนนักพัฒนาแอป ดังนี้
ลิงก์ Merchant Center กับโปรเจ็กต์ Google Cloud: ระบบจะสร้างลิงก์โดยอัตโนมัติ เนื่องจากผู้เรียกมีสิทธิ์เข้าถึงโปรเจ็กต์ Google Cloud ตามโทเค็นการเข้าถึงหรือคีย์ API และเป็นผู้ใช้ที่ได้รับอนุญาตของบัญชี Merchant Center
เพิ่มผู้ใช้ที่เป็นนักพัฒนาแอป API ไปยังบัญชี Merchant Center: หากมีผู้ใช้อยู่แล้ว ระบบจะมอบสิทธิ์เข้าถึงประเภทใหม่ให้ผู้ใช้รายนั้น ในกรณีที่เป็นผู้ใช้ใหม่ ผู้ใช้จะได้รับคำเชิญทางอีเมลของ Merchant Center
หลังจากลงทะเบียนแล้ว คุณสามารถดูสถานะการลงทะเบียนได้โดยใช้ GetDeveloperRegistration หรือยกเลิกการลงทะเบียนได้โดยใช้ UnregisterGCP
การโทรลงทะเบียนคือ
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp
{
developer_email:"example-email@example.com"
}
หลังจากคำขอทำงานสำเร็จแล้ว คุณจะได้รับคำตอบดังนี้
{
"developerRegistration": {
"name": "accounts/ACCOUNT_ID/developerRegistration",
"gcpIds": ["GOOGLE_CLOUD_PROJECT_ID"]
}
}
ดูรหัสบัญชี
คุณดูรหัสบัญชีได้โดยใช้วิธีนี้
accounts.list
คุณสามารถใช้ Google APIs Explorer เพื่อเรียกใช้คำขอ Merchant API โปรแกรมสำรวจ API ใช้ Google OAuth 2.0 สำหรับการตรวจสอบสิทธิ์ ก่อนที่จะเรียกใช้คําขอ ให้เลือกช่องทําเครื่องหมาย Google OAuth 2.0
หากต้องการตรวจสอบสิทธิ์โดยใช้ OAuth 2.0 คุณต้องลงชื่อเข้าใช้บัญชี Google แล้วลงชื่อเข้าใช้โปรแกรมสำรวจ API นอกจากนี้ คุณยังต้องอนุญาตให้ API Explorer จัดการข้อมูลผลิตภัณฑ์และบัญชีของคุณด้วย
คําขอต่อไปนี้แสดงวิธีเรียกดูรหัสบัญชี
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
หรือ
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}
หลังจากเรียกใช้คําขอสําเร็จแล้ว คุณจะเห็นการตอบกลับต่อไปนี้
{
"accounts": [
{
"name": "{ACCOUNT_NAME}",
"accountId": "{ACCOUNT_ID}",
"accountName": "{ACCOUNT_DISPLAY_NAME}",
"timeZone": {
"id": "America/Los_Angeles"
},
"languageCode": "en-US"
}
]
}
คัดลอก {ACCOUNT_ID} ไว้เนื่องจากคุณต้องใช้เพื่อเรียกใช้คำขออื่นๆ
สร้างแหล่งข้อมูลผลิตภัณฑ์หลัก
หากต้องการแทรกผลิตภัณฑ์ คุณต้องมีแหล่งข้อมูลผลิตภัณฑ์หลัก คำขอต่อไปนี้แสดงวิธีสร้างแหล่งข้อมูลที่คุณสามารถใช้เพื่อแทรกผลิตภัณฑ์ลงในบัญชี
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"
}
แทนที่ {ACCOUNT_ID} ด้วยรหัสของบัญชี Merchant Center ที่คุณสร้างขึ้น
หลังจากเรียกใช้คําขอนี้สําเร็จแล้ว คุณจะเห็นการตอบกลับต่อไปนี้
{
"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"
}
คัดลอกค่าของช่อง name เนื่องจากคุณต้องใช้ค่านี้ในการแทรกผลิตภัณฑ์
แหล่งข้อมูลที่สร้างขึ้นจะใช้เวลา 2-3 นาทีจึงจะพร้อมสําหรับการแทรกผลิตภัณฑ์
คุณดูแหล่งข้อมูลนี้ได้ใน UI ของ Merchant Center ดูข้อมูลเพิ่มเติมได้ที่วิธีค้นหาแท็บแหล่งข้อมูล
แทรกผลิตภัณฑ์
หากต้องการแทรกตัวอย่างผลิตภัณฑ์ลงในบัญชี ให้เรียกใช้คําขอต่อไปนี้
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"
}
แทนที่ {DATASOURCE_NAME} ด้วยค่าที่คุณคัดลอกไว้ก่อนหน้านี้
หลังจากเรียกใช้คําขอนี้สําเร็จแล้ว คุณจะเห็นการตอบกลับต่อไปนี้
{
"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"
}
}
รหัสผลิตภัณฑ์ของผลิตภัณฑ์ที่สร้างขึ้นใหม่คือ online~en~US~tshirt-123 คุณใช้วิธี accounts.products.get เพื่อเรียกข้อมูลเกี่ยวกับผลิตภัณฑ์นี้ได้ นอกจากนี้ คุณยังใช้ UI ของ Merchant Center เพื่อดูผลิตภัณฑ์นี้ได้ด้วย