คุณใช้คู่มือนี้เพื่อผสานรวม 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