แค็ตตาล็อก

ส่งการอัพเดตรายการ

หากต้องการส่งการอัพเดตรายการ ให้ใช้ตำแหน่งข้อมูล /{catalog_id}/batch

หากต้องการสร้าง อัพเดต หรือลบรายการในแค็ตตาล็อกของคุณ ให้ทำการเรียกใช้ HTTP POST ไปยัง:

https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/batch?requests=<REQUESTS>

พารามิเตอร์

ชื่อพารามิเตอร์ของ /{catalog_id}/batch และ /{catalog_id}/items_batch อาจดูคล้ายกัน แต่แตกต่างกันอย่างชัดเจน

เราขอแนะนำให้ใช้ API /{catalog_id}/items_batch ซึ่งรองรับกรณีการใช้งานมากกว่าและมีการบำรุงรักษาอย่างต่อเนื่อง

พารามิเตอร์ ประเภท คำอธิบาย

allow_upsert

บูลีน

เมื่อ allow_upsert เป็น false คำขอให้อัพเดตรายการที่ไม่มีอยู่ในแค็ตตาล็อกจะไม่เสร็จสมบูรณ์ หรือไม่เช่นนั้น รายการใหม่จะถูกสร้างขึ้นมาแทน

requests

อ็อบเจ็กต์

อ็อบเจ็กต์ JSON ที่มีคำขอทั้งหมด

requests.data

อ็อบเจ็กต์

อ็อบเจ็กต์ JSON ที่มีช่องและค่าสำหรับหนึ่งรายการ

  • หากเมธอดเป็น CREATE อ็อบเจ็กต์นี้จะต้องมีช่องตามที่กำหนดครบทุกช่อง
  • หากเมธอดเป็น UPDATE จะมีช่องใดก็ได้

หมายเหตุ: ดูช่องที่รองรับที่จะส่งผ่านไปได้

requests.method

สตริง

CREATE, UPDATE, DELETE

requests.retailer_id

สตริง

id ของรายการที่ผู้ลงโฆษณาจัดหาให้ ไม่ใช่ FBID

เมธอด UPDATE ยังสามารถใช้เพื่อสร้างสินค้าได้ด้วย หากยังไม่มีสินค้าดังกล่าวอยู่

โปรดดูรายละเอียดเพิ่มเติมที่ข้อมูลอ้างอิงเกี่ยวกับ API

ข้อจำกัด

  • พารามิเตอร์ requests สามารถมีการอัพเดตได้สูงสุด 5,000 รายการ
  • สำหรับแต่ละแค็ตตาล็อก คุณสามารถเรียกใช้ได้ในจำนวนต่อชั่วโมงตามที่กำหนดโดยสูตรขีดจำกัดอัตรากรณีการใช้งานทางธุรกิจสำหรับชุดรายการแค็ตตาล็อก หากจำนวนนี้ยังไม่เพียงพอ โปรดติดต่อเรา
  • แบตช์จะมีขนาดจำกัดอยู่ที่ 5,000 รายการ
  • รหัสข้อผิดพลาด 1 ที่มีข้อความ "Please reduce the amount of data you're asking for, then retry your request" บ่งบอกว่าขนาดข้อมูล (มีหน่วยเป็นไบต์) ที่ได้รับในคำขอ API มีขนาดใหญ่เกินไป สำหรับการแก้ไขปัญหานี้ โปรดลดจำนวนรายการในชุด แล้วลองอีกครั้ง วิธีนี้จะช่วยให้คำขอนั้นอยู่ในขีดจำกัดด้านขนาดที่ยอมรับได้และสามารถประมวลผลได้สำเร็จ

ช่องที่รองรับ

โปรดดูดูช่องที่รองรับสำหรับตำแหน่งข้อมูล /{catalog_id}/items_batch:

เรียนรู้เพิ่มเติม