ความเข้ากันได้ของ Content API สำหรับ Shopping

คุณใช้คู่มือนี้เพื่อผสานรวม 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 ทั้งหมด โปรดดู คำแนะนำต่อไปนี้สำหรับการเปลี่ยนแปลงคุณลักษณะบางอย่าง

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

ก่อนหน้า
คู่มือเริ่มใช้งานฉบับย่อ
ถัดไป
ย้ายข้อมูลการจัดการบัญชี