ฉันจะรับสถานะของข้อเสนอผลิตภัณฑ์ได้อย่างไร

เมื่อคุณเพิ่มหรืออัปเดตข้อเสนอผลิตภัณฑ์ในแค็ตตาล็อกหรือร้านค้า ข้อเสนอจะผ่านการตรวจสอบเบื้องต้นก่อนที่จะผ่านการตรวจสอบทางบรรณาธิการ กระบวนการดังกล่าวอาจใช้เวลาถึง 36 ชั่วโมง หากต้องการดูว่าข้อเสนอผ่านกระบวนการตรวจสอบหรือไม่ ให้ใช้ทรัพยากร สถานะ

หมายเหตุ

หากต้องการรับรายการผลิตภัณฑ์ที่มีการตั้งค่าสถานะเป็น ไม่อนุมัติ หรือ คําเตือน ให้ดู การรับสถานะของข้อเสนอผลิตภัณฑ์ของคุณ

ต่อไปนี้คือ URI พื้นฐานที่คุณใช้เพื่อรับ Status ทรัพยากร

https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/

หากต้องการรับสถานะของข้อเสนอผลิตภัณฑ์ ให้ผนวกเทมเพลตต่อไปนี้เข้ากับ URI พื้นฐาน

{bmcMerchantId}/catalogs/{catalogId}/status

ตั้งค่า {bmcMerchantId} เป็น ID ร้านค้า BMC ของคุณและตั้งค่า {catalogId} เป็น ID ของแค็ตตาล็อกที่มีข้อเสนอผลิตภัณฑ์ที่คุณต้องการรับสถานะ

คําขอ HTTP แต่ละรายการต้องมีโทเค็นการเข้าถึง OAuth ของผู้ใช้และโทเค็นนักพัฒนาของคุณ หากต้องการระบุโทเค็นการเข้าถึงของผู้ใช้ ให้ตั้งค่าส่วนหัว AuthenticationToken หากต้องการระบุโทเค็นนักพัฒนาของคุณ ให้ตั้งค่าส่วนหัว DeveloperToken

ถ้าคุณจัดการแค็ตตาล็อกในนามของลูกค้ารายอื่น คุณต้องตั้งค่า:

• ส่วนหัว CustomerId ไปยัง ID ลูกค้าของลูกค้าที่ร้านค้าที่คุณกําลังจัดการอยู่
• ส่วนหัว CustomerAccountId ไปยัง ID บัญชีของบัญชีของลูกค้าที่คุณจัดการ (ไม่สําคัญว่าบัญชีที่มีการจัดการใด)

คุณไม่จําเป็นต้องระบุโทเค็นการเข้าถึงหรือโทเค็นนักพัฒนาเพื่อดาวน์โหลดรายงาน คุณต้องระบุเพื่อรับสถานะเท่านั้น

ตามค่าเริ่มต้น API เนื้อหาใช้ออบเจ็กต์ JSON เพื่อแสดงสถานะ เมื่อต้องการใช้ XML ให้ตั้งค่าพารามิเตอร์คิวรี alt เป็น XML

ส่งคําขอ HTTP GET ไปยัง URL ผลลัพธ์ การตอบสนองมีวัตถุ สถานะ ที่มีจํานวนข้อเสนอที่ผ่านหรือล้มเหลวใน 30 วันที่ผ่านมา ถ้าข้อเสนอล้มเหลวในการตรวจทาน Status ทรัพยากรจะมี URL ที่คุณสามารถใช้เพื่อดาวน์โหลดรายงานที่อธิบายสาเหตุที่ทําให้ข้อเสนอล้มเหลว

รายการต่อไปนี้แสดงตัวอย่าง Status ออบเจ็กต์

{
  "catalogId": 12345,
  "publishedCount": 80,
  "rejectedCount": 6,
  "rejectionReportUrl": "https://merchantcenter.bingads.microsoft.com/api/Public/DownloadFeedReport?token=..."
}

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

เนื่องจากไฟล์รายงานมีการบีบอัด ZIP คุณต้องคลายการบีบอัดไฟล์เพื่ออ่านรายงาน ไม่มีขีดจํากัดสําหรับจํานวนรายงานที่ระบบสามารถจัดเก็บได้ อย่างไรก็ตาม ไม่ได้กําหนดระยะเวลาที่จัดเก็บรายงาน สําหรับข้อมูลเกี่ยวกับเนื้อหาของรายงาน ให้ดู รูปแบบรายงาน

รายงานอาจมีขนาดใหญ่ โดยขึ้นอยู่กับกิจกรรมที่เกี่ยวข้องกับแค็ตตาล็อก คุณไม่ควรร้องขอรายงานบ่อยเกินกว่าความจําเป็น ช่วงเวลาที่แนะนําคือไม่เกินหนึ่งครั้งต่อชั่วโมง

สําหรับตัวอย่างโค้ดที่แสดงวิธีการรับสถานะของแค็ตตาล็อกและดาวน์โหลดรายงาน ดูดาวน์โหลดรายงานสถานะแค็ตตาล็อก

ต่อไปนี้แสดงตัวอย่างรายงาน

"Catalog Name","Catalog Id","Store Id","Upload Time"
"Default Catalog","1234","5678","04/21/2016 01:59:06"

"Item Id","Message","Type","Values","Offer Snippet"
"SKU1234","The product URL should be a sub-path of the store's domain. ","Error","",";eBay Motors>Parts & Accessories>Car & Truck Parts>Brakes>Brake Hoses>;http://contentapis.cloudapp.net/sku123;http://i.ebayimg.com/00/s/NzY4WDI5Mg==/z/irkAAOxyB9RS14Rj/$_1.JPG?set_id=880000500F;24.25;-1;;"
"SKU5678","The product URL should be a sub-path of the store's domain. ","Error","",";;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=Ma8674a23cc755995efecf822b3836f07o0&pid=Api;1205;-1;;"
"SKU0987","The product URL should be a sub-path of the store's domain. ","Error","",";Apparel & Accessories > Clothing > Outerwear;http://v-vagancclaimedapi.cloudapp.net/;http://google.com/;1;-1;;"
"SKU6543","The price field is required.","Error","","Mens T-shirt;N/A;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=OIP.Ma8674a23cc755995efecf822b3836f07o0&pid=Api;N/A"
"SKU2435","The offer expiration date is in the past.","Error","","full product title;Apparel & Accessories > Clothing > Outerwear;http://v-vagancclaimedapi.cloudapp.net/;http://google.com/;1.00"
"SKU8675","The price field is required.","Error","","Mens T-shirt;N/A;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=OIP.Ma8674a23cc755995efecf822b3836f07o0&pid=Api;N/A"