คุณใช้คู่มือนี้เพื่อผสานรวม Merchant API กับ การใช้งาน Content API for Shopping ที่มีอยู่
เริ่มต้นใช้งาน
โปรดดูรายละเอียดเกี่ยวกับการออกแบบ Merchant API Merchant API และ API ย่อย
หากต้องการเริ่มใช้ Merchant API ให้เปลี่ยน URL คำขอเป็นดังนี้ รูปแบบ:
https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…
โปรดดูคู่มือเริ่มใช้งานฉบับย่อและ ข้อมูลอ้างอิง Merchant API สำหรับข้อมูลเพิ่มเติม
การรองรับ gRPC
Merchant API รองรับ gRPC และ REST คุณสามารถใช้ gRPC สำหรับ Merchant API และ REST สำหรับ Content API for Shopping พร้อมกัน
ไลบรารีของไคลเอ็นต์ Merchant API กำหนดให้มี gRPC
ดูข้อมูลเพิ่มเติมในใช้ gRPC
ความเข้ากันได้
คู่มือนี้อธิบายการเปลี่ยนแปลงทั่วไปที่ใช้กับ Merchant API ทั้งหมด โปรดดู คำแนะนำต่อไปนี้สำหรับการเปลี่ยนแปลงคุณลักษณะบางอย่าง
- ย้ายข้อมูลการจัดการบัญชี
- ย้ายข้อมูลการตั้งค่าการจัดส่ง
- ย้ายข้อมูลการจัดการผลิตภัณฑ์
- ย้ายข้อมูลการจัดการแหล่งข้อมูล
- ย้ายข้อมูลการจัดการสินค้าคงคลัง
- ย้ายข้อมูลการจัดการโปรโมชัน
- ย้ายข้อมูลการจัดการการรายงาน
- ย้ายข้อมูลการจัดการแหล่งที่มาของ Conversion
- ย้ายข้อมูลการจัดการพาร์ทเนอร์ทางธุรกิจสำหรับฟีดในพื้นที่
Merchant API ออกแบบมาให้ทำงานร่วมกับ Content API for Shopping ที่มีอยู่ เวอร์ชัน 2.1
เช่น คุณสามารถใช้ Merchant Inventories API ร่วมกับ
พื้นที่โฆษณา Content API for Shopping เวอร์ชัน 2.1 และ
products
คุณ
อาจใช้ Content API for Shopping เพื่ออัปโหลด
ผลิตภัณฑ์ (ที่คุณขาย
ในร้านค้าในพื้นที่) แล้วใช้ Merchant Inventories API
LocalInventory
เพื่อจัดการข้อมูลในร้านสำหรับผลิตภัณฑ์นั้น
คำขอแบบกลุ่ม
Merchant API ไม่รองรับเมธอด customBatch
ที่แสดงใน
Content API for Shopping โปรดดูหัวข้อส่งกลุ่ม
คำขอ หากคุณใช้ customBatch
และ
หากจำเป็นต้องใช้ฟีเจอร์นี้สำหรับ Merchant API โปรดบอกเหตุผลให้เราทราบ
ความคิดเห็น
รหัสระบุ
เพื่อให้สอดคล้องกับหลักการในการปรับปรุง API ของ Google เราจึงได้ดำเนินการ ได้ทำการเปลี่ยนแปลงบางอย่างกับตัวระบุสำหรับทรัพยากร Merchant API
ชื่อแทนที่รหัส
ทรัพยากร Merchant API ทั้งหมดจะใช้ช่อง name
เป็นตัวระบุที่ไม่ซ้ำกัน
ต่อไปนี้คือตัวอย่างวิธีใช้ช่อง name
ในการโทร
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert
ช่อง name
ใหม่นี้จะแสดงผลเป็นตัวระบุทรัพยากรสำหรับการอ่านและ
เขียนการเรียกใน Merchant API
ค่าที่แสดงผลในช่อง name
ใช้รูปแบบรหัสใหม่
เช่น ใช้เมธอด getName()
เพื่อเรียกข้อมูล name
จาก
และจัดเก็บเอาต์พุตเป็นตัวแปรแทนการสร้างname
จากตัวผู้ขายและรหัสทรัพยากรด้วยตัวเอง
รูปแบบรหัสใหม่
ใน Merchant API รหัสทรัพยากรจะใช้รูปแบบต่อไปนี้
channel~language~feedLabel~offerId
ทรัพยากร Content API ที่ใช้ :
แทน ~
ระหว่างแต่ละค่าในรหัส
channel:language:feedLabel:offerId
การเรียก Merchant API ทั้งหมดจะแสดงรูปแบบใหม่ที่มี ~
ระหว่างค่าของ
ID เราขอแนะนำให้เก็บรูปแบบใหม่จากคำตอบและใช้ใน
ครั้งต่อๆ ไป
ช่องระดับบนสุดสำหรับทรัพยากรย่อย
ใน Merchant API ทรัพยากรย่อยทั้งหมดจะมีช่อง parent
คุณสามารถใช้
ช่อง parent
เพื่อระบุ name
ของทรัพยากรที่จะแทรกรายการย่อย
แทนที่จะส่งต่อทรัพยากรระดับบนสุดทั้งหมด นอกจากนี้คุณยังใช้ parent
ได้
ที่มีเมธอด list
รายการเพื่อแสดงรายการทรัพยากรย่อยของ parent
นั้น
เช่น หากต้องการแสดงรายการสินค้าคงคลังในร้านสำหรับผลิตภัณฑ์หนึ่งๆ ให้ระบุ
name
ของผลิตภัณฑ์ใน
parent
สำหรับฟิลด์
list
ในกรณีนี้ product
ที่ระบุคือ parent
ของ
LocalInventory
ทรัพยากรที่ถูกส่งกลับ
ประเภท
ตัวอย่างประเภทที่ใช้บ่อยใน API ย่อยของ Merchant API มีดังนี้
ราคา
สิ่งที่เปลี่ยนแปลงไปสำหรับ Price
ในแพ็กเกจ Merchant Common มีดังนี้
Content API | API ผู้ขาย | |
---|---|---|
ช่องจำนวนเงิน | value:string |
amountMicros:int64 |
ช่องสกุลเงิน | currency:string
|
currencyCode:string |
ตอนนี้ระบบบันทึกจำนวน Price
เป็นไมโคร โดยที่ 1 ล้านไมโครคือ
เทียบเท่ากับหน่วยมาตรฐานของสกุลเงินของคุณ
ใน Content API for Shopping Price
เป็นเลขทศนิยมในรูปแบบ
สตริง
ชื่อช่องจำนวนเงินเปลี่ยนจาก value
เป็น amountMicros
แล้ว
ชื่อช่องสกุลเงินเปลี่ยนจาก currency
เป็น currencyCode
รูปแบบยังคงเป็น ISO 4217