คุณใช้คู่มือนี้เพื่อผสานรวม Merchant API กับการใช้งาน Content API for Shopping ที่มีอยู่ได้
เริ่มต้นใช้งาน
ดูรายละเอียดเกี่ยวกับ Merchant API และ API ย่อยได้ที่การออกแบบ Merchant 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 v2.1 ที่มีอยู่และการใช้งาน products
คุณอาจใช้ Content API for Shopping เพื่ออัปโหลดผลิตภัณฑ์ในร้านใหม่ (ที่ขายในร้านค้าในพื้นที่) จากนั้นใช้ทรัพยากร Merchant Inventories API LocalInventory
เพื่อจัดการข้อมูลในร้านค้าสำหรับผลิตภัณฑ์นั้น
คำขอแบบกลุ่ม
Merchant API ไม่รองรับเมธอด customBatch
ที่แสดงใน Content API for Shopping โปรดดูหัวข้อส่งคำขอแบบกลุ่มแทน หากคุณใช้ customBatch
และต้องการฟีเจอร์นี้สำหรับ Merchant API โปรดบอกเหตุผลให้เราทราบในความคิดเห็นของคุณ
ตัวระบุ
เราได้ทำการเปลี่ยนแปลงบางอย่างกับตัวระบุสำหรับทรัพยากร Merchant API เพื่อให้สอดคล้องกับหลักการปรับปรุง API ของ Google
ชื่อแทนที่รหัส
ทรัพยากร 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 ทั้งหมดจะแสดงรูปแบบใหม่โดยมี ~
ระหว่างค่าของรหัส เราขอแนะนำให้จัดเก็บรูปแบบใหม่จากคำตอบและนำไปใช้ในการเรียกใช้ในอนาคต
ช่องระดับบนสุดสำหรับทรัพยากรย่อย
ใน 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