การจัดการแค็ตตาล็อกของคุณ
API เนื้อหาเป็น API RESTful ที่ใช้ทรัพยากร แค็ตตาล็อก เพื่อจัดการแค็ตตาล็อกในที่เก็บ Microsoft Merchant Center (MMC) ของคุณ
ต่อไปนี้คือ URI พื้นฐานที่คุณใช้เพื่อเรียกใช้ API เนื้อหา
https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/
คําขอ HTTP แต่ละรายการต้องมีโทเค็นการเข้าถึง OAuth ของผู้ใช้และโทเค็นนักพัฒนาของคุณ หากต้องการระบุโทเค็นการเข้าถึงของผู้ใช้ ให้ตั้งค่าส่วนหัว AuthenticationToken หากต้องการระบุโทเค็นนักพัฒนาของคุณ ให้ตั้งค่าส่วนหัว DeveloperToken
ถ้าคุณจัดการแค็ตตาล็อกในนามของลูกค้ารายอื่น คุณต้องตั้งค่า:
- ส่วนหัว CustomerId ไปยัง ID ลูกค้าของลูกค้าที่ร้านค้าที่คุณกําลังจัดการอยู่
- ส่วนหัว CustomerAccountId ไปยัง ID บัญชีของบัญชีของลูกค้าที่คุณจัดการ (ไม่สําคัญว่าบัญชีที่มีการจัดการใด)
ตามค่าเริ่มต้น API เนื้อหาใช้ออบเจ็กต์ JSON เพื่อแสดงแค็ตตาล็อก เมื่อต้องการใช้ XML ให้ตั้งค่าพารามิเตอร์คิวรี alt เป็น XML
สําหรับรายละเอียดเกี่ยวกับการใช้ทรัพยากรแค็ตตาล็อก ดูส่วนต่อไปนี้
- การรับแค็ตตาล็อกจากที่เก็บ
- กําลังนํารายการแค็ตตาล็อกจากที่เก็บ
- การลบแค็ตตาล็อกจากที่เก็บ
- การเพิ่มแค็ตตาล็อกไปยังที่เก็บ
- การอัปเดตแค็ตตาล็อกในที่เก็บ
สําหรับตัวอย่างโค้ดที่แสดงวิธีการรับ เพิ่ม อัปเดต และลบแค็ตตาล็อก ให้ดู การจัดการรหัสแค็ตตาล็อก
การรับแค็ตตาล็อกจากที่เก็บ
เมื่อต้องการรับแค็ตตาล็อกจากร้านค้า ให้ผนวกเทมเพลตต่อไปนี้เข้ากับ URI พื้นฐาน
{bmcMerchantId}/catalogs/{catalogId}
ตั้งค่า {bmcMerchantId} เป็น ID ที่เก็บ MMC ของคุณและตั้งค่า {catalogId} เป็น ID ของแค็ตตาล็อก
ส่งคําขอ HTTP GET ไปยัง URL ผลลัพธ์ ถ้าพบแค็ตตาล็อก การตอบกลับจะประกอบด้วยวัตถุ แค็ตตาล็อก ที่มีรายละเอียดของแค็ตตาล็อก
การรับรายการแค็ตตาล็อกจากที่เก็บ
เมื่อต้องการรับรายการของแค็ตตาล็อกจากร้านค้า ให้ผนวกเทมเพลตต่อไปนี้เข้ากับ URI พื้นฐาน
{bmcMerchantId}/catalogs
ตั้งค่า {bmcMerchantId} เป็น ID ร้านค้า MMC ของคุณ
ส่งคําขอ HTTP GET ไปยัง URL ผลลัพธ์ ถ้าที่เก็บมีแค็ตตาล็อก การตอบกลับจะประกอบด้วยวัตถุ แค็ตตาล็อก ที่ประกอบด้วยรายการของแค็ตตาล็อก
การลบแค็ตตาล็อกจากที่เก็บ
เมื่อต้องการลบแค็ตตาล็อกจากที่เก็บ ให้ผนวกเทมเพลตต่อไปนี้เข้ากับ URI พื้นฐาน
{bmcMerchantId}/catalogs/{catalogId}
ตั้งค่า {bmcMerchantId} เป็น ID ที่เก็บ MMC ของคุณและตั้งค่า {catalogId} เป็น ID ของแค็ตตาล็อก
ส่งคําขอ HTTP DELETE ไปยัง URL ผลลัพธ์ ถ้าพบแค็ตตาล็อก แค็ตตาล็อกนั้นจะถูกลบออก
การเพิ่มแค็ตตาล็อกไปยังที่เก็บ
คุณใช้แค็ตตาล็อกเพื่อจัดกลุ่มผลิตภัณฑ์ของคุณอย่างมีตรรกะ เมื่อต้องการเพิ่มแค็ตตาล็อกไปยังร้านค้า ให้ผนวกเทมเพลตต่อไปนี้เข้ากับ URI พื้นฐาน
{bmcMerchantId}/catalogs
ตั้งค่า {bmcMerchantId} เป็น ID ร้านค้า MMC ของคุณ
ส่งคําขอ HTTP POST ไปยัง URL ผลลัพธ์ ถ้าแค็ตตาล็อกถูกเพิ่ม การตอบสนองจะประกอบด้วยวัตถุแค็ตตาล็อก วัตถุ Catalog มี ID ของแค็ตตาล็อก ใช้ ID เพื่อรับและลบแค็ตตาล็อก
เนื้อความของการร้องขอเป็นวัตถุแค็ตตาล็อก คุณต้องระบุเขตข้อมูลต่อไปนี้
ชื่อที่คุณระบุต้องไม่ซ้ํากันภายในร้านค้า และจํากัดไว้ที่ไม่เกิน 70 อักขระ ตลาดระบุตําแหน่งที่ให้บริการผลิตภัณฑ์ สําหรับรายการของตลาดที่สนับสนุน ดูตลาด ผลิตภัณฑ์จะได้รับบริการเฉพาะเมื่อisPublishingEnabledเป็นจริงเท่านั้น สําหรับรายละเอียดเกี่ยวกับวิธีการที่คุณสามารถใช้isPublishingEnabledสําหรับการทดสอบแอปของคุณ ดูการทดสอบโค้ดของคุณใน Sandbox
การอัปเดตแค็ตตาล็อกในที่เก็บ
เมื่อต้องการอัปเดตแค็ตตาล็อกในที่เก็บ ให้ผนวกเทมเพลตต่อไปนี้เข้ากับ URI พื้นฐาน
{bmcMerchantId}/catalogs/{catalogId}
ตั้งค่า {bmcMerchantId} เป็น ID ที่เก็บ MMC ของคุณและตั้งค่า {catalogId} เป็น ID ของแค็ตตาล็อก
เนื้อความของการร้องขอเป็นวัตถุแค็ตตาล็อก คุณต้องระบุเขตข้อมูลต่อไปนี้
ส่งคําขอ HTTP PUT ไปยัง URL ผลลัพธ์ ถ้ามีการอัปเดตแค็ตตาล็อก การตอบสนองจะประกอบด้วยวัตถุ แค็ตตาล็อก ที่อัปเดตแล้ว