ทรัพยากรผลิตภัณฑ์
ทรัพยากรผลิตภัณฑ์ช่วยให้คุณสามารถจัดการข้อเสนอผลิตภัณฑ์ใน Microsoft Merchant Center Store (MMC) ของคุณได้ สําหรับข้อมูลเกี่ยวกับการใช้ทรัพยากรผลิตภัณฑ์ ให้ดู การจัดการผลิตภัณฑ์ของคุณ ตัวอย่างเช่น ที่แสดงวิธีการเพิ่ม ลบ และรับผลิตภัณฑ์ ดูตัวอย่างโค้ด
URI พื้นฐาน
ต่อไปนี้คือ URI พื้นฐานที่คุณผนวกเทมเพลต
https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/
เทมเพลต
หากต้องการสร้างจุดสิ้นสุดที่ใช้ในการจัดการข้อเสนอผลิตภัณฑ์ของคุณ ให้ผนวกเทมเพลตที่เหมาะสมเข้ากับ URI พื้นฐาน
แม่ แบบ | คํากริยา HTTP | คำอธิบาย | ทรัพยากร |
---|---|---|---|
{mmcMerchantId}/products/batch |
ประกาศ | ใช้ เพื่อทําการแทรกหลายครั้ง (อัปเดต) รับ และลบในการร้องขอเดียว ชุดงานต้องไม่รวมการดําเนินการหลายอย่างสําหรับผลิตภัณฑ์เดียวกัน ตัวอย่างเช่น คําขอต้องไม่พยายามแทรกและลบผลิตภัณฑ์เดียวกัน ตั้งค่า {mmcMerchantId} เป็น ID ที่เก็บ MMC |
การร้องขอ: ชุดงาน การตอบสนอง: ชุดงาน |
{mmcMerchantId}/products/{productUniqueId} |
ลบ | ใช้ เพื่อลบข้อเสนอผลิตภัณฑ์เดียวจากร้านค้า ตั้งค่า {mmcMerchantId} เป็น ID ที่เก็บ MMCตั้งค่า {productUniqueId} เป็น รหัส ผลิตภัณฑ์ที่มีคุณสมบัติครบถ้วน (ตัวอย่างเช่น Online:en:US:Sku123)ถ้าคุณแทรกผลิตภัณฑ์ที่มี ID เดียวกันในแค็ตตาล็อกหลายแค็ตตาล็อก ผลิตภัณฑ์นั้นจะถูกลบออกจากแค็ตตาล็อกทั้งหมด ผลิตภัณฑ์ที่ถูกลบอาจใช้เวลาถึง 12 ชั่วโมงในการหยุดการจัดส่ง เราขอแนะนําให้อัปเดตความพร้อมใช้งานของผลิตภัณฑ์เป็น "สินค้าหมด" ก่อนที่จะลบ |
การร้องขอ: N/A การตอบสนอง: N/A |
{mmcMerchantId}/products/{productUniqueId} |
รับ | ใช้ เพื่อรับข้อเสนอผลิตภัณฑ์เดียวจากร้านค้า ตั้งค่า {mmcMerchantId} เป็น ID ที่เก็บ MMCตั้งค่า {productUniqueId} เป็น รหัส ผลิตภัณฑ์ที่มีคุณสมบัติครบถ้วน (ตัวอย่างเช่น Online:en:US:Sku123)ถ้าคุณแทรกผลิตภัณฑ์ที่มี ID เดียวกันในหลายแค็ตตาล็อก บริการจะส่งกลับเพียงหนึ่งรายการเท่านั้น และรายการใดที่ไม่ได้รับการกําหนด |
การร้องขอ: N/A การตอบสนอง: ผลิตภัณฑ์ |
{mmcMerchantId}/products |
รับ | ใช้ เพื่อรับรายการผลิตภัณฑ์ในร้านค้า ตั้งค่า {mmcMerchantId} เป็น ID ที่เก็บ MMC |
การร้องขอ: N/A การตอบสนอง: ผลิตภัณฑ์ |
{mmcMerchantId}/products |
ประกาศ | ใช้เพื่อแทรก (อัปเดต) ข้อเสนอผลิตภัณฑ์เดียวในร้านค้า ถ้าไม่มีผลิตภัณฑ์อยู่ ก็จะถูกเพิ่ม มิฉะนั้น ผลิตภัณฑ์จะได้รับการอัปเดต เนื่องจากการอัปเดตจะเขียนทับข้อเสนอปัจจุบัน คุณต้องรวมเขตข้อมูลทั้งหมดที่ประกอบเป็นข้อเสนอ เมื่อต้องการแทรกข้อเสนอลงในแค็ตตาล็อกที่ระบุ ให้ระบุพารามิเตอร์คิวรี bmc-catalog-id มิฉะนั้น ผลิตภัณฑ์จะถูกแทรกลงในแค็ตตาล็อกเริ่มต้นของร้านค้า ตั้งค่า {mmcMerchantId} เป็น ID ที่เก็บ MMCโปรดทราบว่า เนื่องจากคําขอรับ/รายการและลบดําเนินการกับร้านค้าและไม่ใช่แค็ตตาล็อกเฉพาะ คุณไม่ควรแทรกผลิตภัณฑ์ที่มี แชนเนลเนื้อหาภาษาเป้าหมาย Country และ offerId เดียวกันลงในหลายแค็ตตาล็อก |
คําขอ: ผลิตภัณฑ์ การตอบสนอง: ผลิตภัณฑ์ |
พารามิเตอร์คิวรี
ปลายทางอาจรวมถึงพารามิเตอร์คิวรีต่อไปนี้
พารามิเตอร์ | คำอธิบาย |
---|---|
Alt | เสริม ใช้ เพื่อระบุชนิดของเนื้อหาที่ใช้ในการร้องขอและการตอบกลับ ค่าที่เป็นไปได้คือ json และxml ค่าเริ่มต้นคือjson |
bmc-แค็ตตาล็อก-id | เสริม ใช้เพื่อระบุแค็ตตาล็อกเพื่อแทรกข้อเสนอผลิตภัณฑ์ (อัปเดต) ใช้พารามิเตอร์นี้ถ้าร้านค้าของคุณประกอบด้วยหลายแค็ตตาล็อก ถ้าคุณไม่ได้ระบุพารามิเตอร์นี้ ผลิตภัณฑ์จะถูกแทรกลงในแค็ตตาล็อกเริ่มต้นของร้านค้า พารามิเตอร์นี้ใช้เพื่อแทรกข้อเสนอผลิตภัณฑ์เท่านั้น พารามิเตอร์นี้ถูกละเว้นสําหรับการร้องขอรับ รายการ และลบเนื่องจากดําเนินการข้ามแค็ตตาล็อก |
แห้ง- ทํางาน | เสริม ใช้เมื่อดีบักแอปพลิเคชันของคุณเพื่อทดสอบการโทร การเรียกใช้ที่รวมพารามิเตอร์นี้จะไม่ส่งผลกระทบต่อข้อมูลการผลิต (ผลิตภัณฑ์จะไม่ถูกแทรกหรือลบ) อย่างไรก็ตาม การตอบสนองจะมีข้อผิดพลาดใดๆ ที่การเรียกสร้างขึ้น พิจารณาข้อจํากัดต่อไปนี้เมื่อใช้พารามิเตอร์นี้
|
ผลลัพธ์สูงสุด | เสริม ใช้ เพื่อระบุจํานวนสูงสุดของหน่วยข้อมูลที่จะส่งกลับในการร้องขอรายการ ค่าสูงสุดที่คุณอาจระบุคือ 250 ค่าเริ่มต้นคือ 25 |
start-token | เสริม ใช้ เพื่อไปยังหน้าผ่านรายการผลิตภัณฑ์ของร้านค้า โทเค็นจะระบุหน้าถัดไปของผลิตภัณฑ์ที่จะส่งกลับในคําขอรายการ ไม่ต้องระบุพารามิเตอร์นี้ในการร้องขอรายการแรก ถ้าแค็ตตาล็อกมีจํานวนผลิตภัณฑ์ที่ร้องขอมากกว่า (ดูพารามิเตอร์คิวรี ผลลัพธ์สูงสุด ) การตอบสนองจะรวมถึง nextPageToken เขตข้อมูล (ดู ผลิตภัณฑ์) ซึ่งประกอบด้วยค่าโทเค็นที่คุณใช้ในคําขอรายการถัดไป |
หัว กระดาษ
ต่อไปนี้คือส่วนหัวของคําขอและการตอบสนอง
หัว ข้อ | คำอธิบาย |
---|---|
AuthenticationToken | ส่วนหัวของคําขอ ตั้งค่าส่วนหัวนี้เป็นโทเค็นการเข้าถึง OAuth สําหรับข้อมูลเกี่ยวกับการรับโทเค็นการเข้าถึง ให้ดู การรับรองความถูกต้องข้อมูลประจําตัวของคุณ |
เนื้อหา-ตําแหน่งที่ตั้ง | ส่วนหัวการตอบสนอง URL ที่ระบุร้านค้าที่มีการแทรกผลิตภัณฑ์เข้าไป ส่วนหัวนี้จะรวมอยู่ในการตอบสนองของคําขอแทรก |
Content-Type | ส่วนหัวคําขอและการตอบสนอง ชนิดของเนื้อหาในเนื้อความของการร้องขอหรือการตอบสนอง สําหรับ POST ถ้าคุณใช้ JSON ให้ตั้งค่าส่วนหัว application/json นี้เป็น มิฉะนั้น ถ้าคุณใช้ XML ให้ตั้งค่าส่วนหัว application/xml นี้เป็น |
CustomerAccountId | ส่วนหัวของคําขอ ID บัญชีของบัญชีใดๆ ที่คุณจัดการในนามของลูกค้าที่ระบุไว้ใน CustomerId ส่วนหัว ไม่สําคัญว่าคุณระบุบัญชีใด ระบุหัวข้อนี้เฉพาะเมื่อคุณจัดการบัญชีในนามของลูกค้าเท่านั้น |
CustomerId | ส่วนหัวของคําขอ รหัสลูกค้าของลูกค้าที่คุณจัดการร้านค้า ระบุหัวข้อนี้เฉพาะเมื่อคุณจัดการร้านค้าในนามของลูกค้าเท่านั้น หากคุณตั้งค่าส่วนหัวนี้ คุณต้องตั้งค่า CustomerAccountId ส่วนหัวด้วย |
DeveloperToken | ส่วนหัวของคําขอ โทเค็นนักพัฒนาของแอปพลิเคชันไคลเอ็นต์ แต่ละคําขอต้องมีส่วนหัวนี้ สําหรับข้อมูลเกี่ยวกับการรับโทเค็น ให้ดูที่ คุณมีข้อมูลประจําตัว Microsoft Advertising และโทเค็นสําหรับนักพัฒนาหรือไม่ |
สถาน | ส่วนหัวการตอบสนอง URL ที่ระบุร้านค้าที่มีการแทรกผลิตภัณฑ์เข้าไป ส่วนหัวนี้จะรวมอยู่ในการตอบสนองของคําขอแทรก |
WebRequestActivityId | ส่วนหัวการตอบสนอง ID ของรายการแฟ้มบันทึกที่ประกอบด้วยรายละเอียดของการร้องขอ คุณควรจับภาพ ID นี้เสมอถ้ามีข้อผิดพลาดเกิดขึ้น หากคุณไม่สามารถระบุและแก้ไขปัญหาได้ ให้ใส่ ID นี้พร้อมกับข้อมูลอื่น ๆ ที่คุณให้ทีมสนับสนุน |
วัตถุการร้องขอและการตอบสนอง
ต่อไปนี้คือคําขอและวัตถุการตอบสนองที่ใช้โดย API
แต่ละวัตถุจะกําหนดชื่อคีย์ JSON และชื่อองค์ประกอบ XML ที่คุณใช้โดยขึ้นอยู่กับชนิดเนื้อหาที่คุณระบุสําหรับคําขอ
วัตถุ | คำอธิบาย |
---|---|
ชุด | กําหนดรายการข้อมูลที่จะประมวลผลในคําขอชุดงาน |
ข้อผิดพลาด | กําหนดข้อผิดพลาด |
ErrorResponse | กําหนดวัตถุข้อผิดพลาดระดับบนสุดสําหรับการแทรกผลิตภัณฑ์เดียว |
BatchItemError | กําหนดข้อผิดพลาดที่เกิดขึ้นสําหรับสินค้าในระหว่างการประมวลผลชุดงาน |
สินค้า | กําหนดรายการในคําขอชุดงานหรือการตอบสนอง |
ผลิตภัณฑ์ | กําหนดผลิตภัณฑ์ |
ProductCustomAttribute | กําหนดแอตทริบิวต์แบบกําหนดเอง |
ProductCustomGroup | กําหนดกลุ่มของแอตทริบิวต์แบบกําหนดเอง |
ProductDestination | กําหนดปลายทาง |
ProductPrice | กําหนดราคาของผลิตภัณฑ์ |
ProductTax | กําหนดที่ตั้งทางภูมิศาสตร์ที่กําหนดภาษีที่เกี่ยวข้อง |
ผลิตภัณฑ์ | กําหนดรายการผลิตภัณฑ์ |
ProductShipping | กําหนดต้นทุนการจัดส่ง |
ProductShippingWeight | กําหนดน้ําหนักการจัดส่งของสินค้า |
UnitPricing | กําหนดสินค้าต่อราคาต่อหน่วย |
คำเตือน | กําหนดข้อความเตือน |
ชุด
กําหนดรายการข้อมูลที่จะประมวลผลในคําขอชุดงาน โปรดสังเกตว่า วัตถุนี้ถูกใช้ในการร้องขอและการตอบสนองของชุดงาน
ชื่อ | ค่า | ชนิด | ชื่อองค์ประกอบ XML |
---|---|---|---|
รายการ | อาร์เรย์ของรายการที่จะประมวลผลในคําขอชุดงาน จํานวนรายการสูงสุดที่คุณสามารถระบุได้คือ 12,000 รายการ อย่างไรก็ตาม ขนาดคําขอสูงสุดคือ 4 MB ดังนั้นจํานวนรายการที่แท้จริงจะขึ้นอยู่กับจํานวนของแอตทริบิวต์ผลิตภัณฑ์ (เช่น ขนาด สี รูปแบบ) ที่คุณรวมไว้ และคุณบีบอัดข้อมูลหรือไม่ ตัวอย่างเช่น ถ้าคุณบีบอัดข้อมูล คุณอาจสามารถระบุ 12,000 รายการ แต่ถ้าคุณไม่ระบุ คุณอาจระบุได้เพียง 2,000 รายการเท่านั้น |
รายการ[] | <ชุด> |
BatchItemError
กําหนดข้อผิดพลาดที่เกิดขึ้นสําหรับสินค้าในระหว่างการประมวลผลชุดงาน
ชื่อ | ค่า | ชนิด | ชื่อองค์ประกอบ XML |
---|---|---|---|
ข้อ ผิด พลาด | รายการข้อผิดพลาดที่เกิดขึ้นขณะประมวลผลรายการ | ข้อผิดพลาด[] | <ข้อ ผิด พลาด> |
รหัส | รหัสสถานะของ HTTP ของข้อผิดพลาด | สตริง | |
ข้อความ | ข้อความที่เกี่ยวข้องกับข้อผิดพลาด | สตริง |
ข้อผิดพลาด
กําหนดข้อผิดพลาด
ชื่อ | ค่า | ชนิด | ชื่อองค์ประกอบ XML |
---|---|---|---|
โด เมน | สําหรับใช้ภายในเท่านั้น | สตริง | <โด เมน> |
สถาน | ไม่ได้ใช้ | สตริง | <ชนิดตําแหน่งที่ตั้ง="สตริง"> |
locationType | ไม่ได้ใช้ | สตริง | ดูแอททริบิวต์<ชนิดขององค์ประกอบตําแหน่งที่ตั้ง> |
ข้อความ | คําอธิบายของข้อผิดพลาด | สตริง | <internalReason> |
เหตุผล | เหตุผลที่คําขอล้มเหลว ตัวอย่างเช่น ผลิตภัณฑ์ล้มเหลวในการตรวจสอบความถูกต้อง | สตริง | <เหตุผล> |
ErrorResponse
กําหนดวัตถุข้อผิดพลาดระดับบนสุดสําหรับการแทรกผลิตภัณฑ์เดียว
ชื่อ | ค่า | ชนิด | ชื่อองค์ประกอบ XML |
---|---|---|---|
ข้อ ผิด พลาด | รายการข้อผิดพลาดที่เกิดขึ้นขณะประมวลผลรายการ | Errors[] | <ข้อ ผิด พลาด> |
ข้อ ผิด พลาด
กําหนดรายการของข้อผิดพลาดและคําเตือนสําหรับข้อเสนอ
ชื่อ | ค่า | ชนิด | ชื่อองค์ประกอบ XML |
---|---|---|---|
ข้อ ผิด พลาด | รายการข้อผิดพลาดที่เกิดขึ้นขณะประมวลผลรายการ | ข้อผิดพลาด[] | <ข้อ ผิด พลาด> |
คำ เตือน | รายการของคําเตือนที่เกิดขึ้นขณะประมวลผลรายการ ข้อเสนอได้รับการยอมรับ แต่คุณควรแก้ไขปัญหาตามความสะดวกแรกสุดของคุณ ตัวอย่างเช่น MMC จะส่งกลับคําเตือนหากคุณไม่ได้ระบุ ตัวระบุ gtin, mpn และ brand หากควรทราบ | คําเตือน[] | <คำ เตือน> |
รหัส | รหัสสถานะ HTTP หรือข้อผิดพลาด | สตริง | |
ข้อความ | ข้อความที่เกี่ยวข้องกับข้อผิดพลาด | สตริง |
สินค้า
กําหนดรายการในคําขอชุดงาน
ชื่อ | ค่า | ชนิด | ชื่อองค์ประกอบ XML |
---|---|---|---|
batchId | ID ที่ผู้ใช้กําหนดเองที่ระบุรายการนี้ในคําขอชุดงาน ถ้าชุดงานมีสินค้า 10 รายการ คุณสามารถกําหนด ID ได้ 1 ถึง 10 | จํานวนเต็มแบบไม่ใส่เครื่องหมาย | <entry batch_id="unsigned integer" method="string"> |
ข้อ ผิด พลาด | วัตถุข้อผิดพลาดที่ประกอบด้วยรายการข้อผิดพลาดในการตรวจสอบความถูกต้องที่เกิดขึ้น การตอบสนองรวมถึงเขตข้อมูลนี้เฉพาะเมื่อมีข้อผิดพลาดเกิดขึ้นเท่านั้น | BatchItemError | <ข้อ ผิด พลาด> |
merchantId | ID ร้านค้า Merchant Center | แบบยาวแบบไม่ใส่ลายเซ็น | <merchant_id> |
วิธี | การกระทําที่จะนําไปใช้กับรายการ ค่าที่เป็นไปได้คือ insert , get และdelete หากสินค้ากําลังเพิ่มหรืออัปเดตข้อเสนอผลิตภัณฑ์ ให้ตั้งค่าวิธีการinsert เป็น ถ้ารายการกําลังลบผลิตภัณฑ์ ให้ตั้งค่าวิธีการ เป็น delete และหากรายการดังกล่าวได้รับผลิตภัณฑ์ ให้ตั้งค่าวิธีการ เป็นget สตริงต้องตรงตามตัวพิมพ์ใหญ่-เล็ก |
สตริง |
method ดูแอตทริบิวต์ของ<องค์ประกอบรายการ> |
ผลิตภัณฑ์ | การเสนอผลิตภัณฑ์ ระบุเขตข้อมูลนี้ในการร้องขอเฉพาะเมื่อแทรก (กําลังอัปเดต) ผลิตภัณฑ์ การตอบกลับจะรวมเขตข้อมูลนี้สําหรับการรับและการแทรก (การอัปเดต) เท่านั้น | ผลิตภัณฑ์ | <ผลิตภัณฑ์> |
productId | รหัสผลิตภัณฑ์ที่มีคุณสมบัติครบถ้วน (ตัวอย่างเช่น Online:en:US:Sku123) รวมเขตข้อมูลนี้เมื่อรับหรือลบข้อเสนอผลิตภัณฑ์เท่านั้น อย่ารวมหลายรายการที่มีรหัสผลิตภัณฑ์เดียวกันในคําขอชุดงาน |
สตริง | <product_id> |
ผลิตภัณฑ์
กําหนดผลิตภัณฑ์ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับเขตข้อมูลในวัตถุนี้ ให้ดูที่ ไฟล์ตัวดึงข้อมูลถูกจัดระเบียบอย่างไร
ชื่อ JSON และ XML | ค่า | ชนิด | จําเป็นสําหรับการแทรก |
---|---|---|---|
additionalImageLinks <additional_image_link> |
URL ของรูปภาพเพิ่มเติมของผลิตภัณฑ์ที่สามารถใช้ในโฆษณาผลิตภัณฑ์ได้ เมื่อต้องการระบุหลายรูป MMC ไม่ได้ใช้รูปภาพเพิ่มเติม ช่องนี้จะรวมอยู่ในความเข้ากันได้ของ Google |
String[] | ไม่ใช่ |
ผู้ใหญ่ <ผู้ใหญ่> |
ค่าบูลีนที่กําหนดว่าสินค้าเป็นผลิตภัณฑ์สําหรับผู้ใหญ่หรือไม่ ตั้งค่าเป็น จริง ถ้าตลาดเป้าหมายของรายการเป็นผู้ใหญ่ ค่าเริ่มต้นคือ เท็จ โปรดทราบว่าผลิตภัณฑ์สําหรับผู้ใหญ่ไม่ได้รับการสนับสนุนและจะถูกปฏิเสธ |
บูลีน | ไม่ใช่ |
adwordsGrouping <adwords_grouping> |
กลุ่มของสินค้าสําหรับการเสนอราคาต้นทุนต่อการซื้อ (CPA) MMC ไม่ได้ใช้เขตข้อมูลนี้ ซึ่งรวมอยู่ในความเข้ากันได้ของ Google |
สตริง | ไม่ใช่ |
adwordsLabels <adwords_label> |
ป้ายชื่อสําหรับรายการที่จัดกลุ่ม (ดู adwordsGrouping) ใช้กับต้นทุนต่อคลิก (CPC) เท่านั้น MMC ไม่ได้ใช้เขตข้อมูลนี้ ซึ่งรวมอยู่ในความเข้ากันได้ของ Google |
String[] | ไม่ใช่ |
adwordsRedirect <adwords_redirect> |
URL ที่จะใช้ในโฆษณาผลิตภัณฑ์ ถ้าระบุ URL นี้ต้องเปลี่ยนเส้นทางไปยัง URL ที่ระบุในลิงก์ | สตริง | ไม่ใช่ |
ageGroup <age_group> |
กลุ่มอายุเป้าหมายของสินค้า ต่อไปนี้คือค่าที่เป็นไปได้
|
สตริง | ไม่ใช่ |
ความพร้อมใช้งาน <ความพร้อมใช้งาน> |
สถานะความพร้อมใช้งานของผลิตภัณฑ์ ต่อไปนี้คือค่าที่เป็นไปได้
|
สตริง | ใช่ |
availabilityDate <availability_date> |
วันที่ UTC ที่ผลิตภัณฑ์สั่งซื้อล่วงหน้าจะพร้อมสําหรับการจัดส่ง (ดูเขตข้อมูล)availability ฟิลด์นี้เป็นทางเลือก แต่ถ้าคุณทราบวันที่ที่ผลิตภัณฑ์ที่สั่งซื้อล่วงหน้าจะพร้อมสําหรับการจัดส่ง คุณควรตั้งค่าเขตข้อมูลนี้ ระบุวันที่ในรูปแบบ ISO 8601หมาย เหตุ: MMC ในขณะนี้ละเว้นเนื้อหาของเขตข้อมูลนี้ |
สตริง | ไม่ใช่ |
แบ รนด์ <แบ รนด์> |
แบรนด์ ผู้ผลิต หรือผู้เผยแพร่ของรายการ สตริงสามารถมีคําได้สูงสุด 10 คําและ 1,000 อักขระ เพื่อให้แน่ใจว่าสตริงแสดงได้ดีใน UX คุณควรจํากัดชื่อแบรนด์ให้ไม่เกิน 70 อักขระ | สตริง | ใช่ |
ช่อง <ช่อง> |
ช่องทางการขายสําหรับผลิตภัณฑ์ ต่อไปนี้คือค่าที่ไม่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้
|
สตริง | ใช่ |
สี <สี> |
สีเด่นของผลิตภัณฑ์ ถ้าสีเป็นการผสมผสานของสี คุณอาจระบุรายการที่คั่นด้วยเครื่องหมายทับได้สูงสุด 3 สี (ตัวอย่างเช่น สีแดง/เขียว/น้ําเงิน) ถ้าชุดมีให้เลือกหลายสี คุณจะสร้างผลิตภัณฑ์สําหรับแต่ละสีและใช้ itemGroupId เพื่อจัดกลุ่มตัวแปรของผลิตภัณฑ์ เขตข้อมูลจะถูกจํากัดไว้ที่ 100 อักขระ แนะนําสําหรับรายการเครื่องแต่งกาย |
สตริง | ไม่ใช่ |
เงื่อนไข <เงื่อนไข> |
เงื่อนไขของผลิตภัณฑ์ ต่อไปนี้คือค่าที่เป็นไปได้
|
สตริง | ใช่ |
contentLanguage <content_language> |
รหัสภาษา ISO 639-1 แบบสองตัวอักษรสําหรับผลิตภัณฑ์ ต่อไปนี้คือค่าที่ไม่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้:
|
สตริง | ใช่ |
customAttributes <custom_attribute> |
รายการแอตทริบิวต์แบบกําหนดเองที่ผู้ขายใช้ | ProductCustomAttribute[] | ไม่ใช่ |
custom_group customGroups<> | รายการกลุ่มแบบกําหนดเองที่ผู้ขายใช้ | ProductCustomGroup[] | ไม่ใช่ |
customLabel0 <custom_label_0> |
ป้ายชื่อแบบกําหนดเอง 0 ซึ่งใช้เพื่อกรองผลิตภัณฑ์สําหรับแคมเปญ Microsoft Shopping ป้ายชื่อจํากัดไว้ที่ 100 ตัวอักษร | สตริง | ไม่ใช่ |
customLabel1 <custom_label_1> |
ป้ายชื่อแบบกําหนดเอง 1 ซึ่งใช้ในการกรองผลิตภัณฑ์สําหรับแคมเปญ Microsoft Shopping ป้ายชื่อจํากัดไว้ที่ 100 ตัวอักษร | สตริง | ไม่ใช่ |
customLabel2 <custom_label_2> |
ป้ายชื่อแบบกําหนดเอง 2 ซึ่งใช้ในการกรองผลิตภัณฑ์สําหรับแคมเปญ Microsoft Shopping ป้ายชื่อจํากัดไว้ที่ 100 ตัวอักษร | สตริง | ไม่ใช่ |
customLabel3 <custom_label_3> |
ป้ายชื่อแบบกําหนดเอง 3 ซึ่งใช้ในการกรองผลิตภัณฑ์สําหรับแคมเปญ Microsoft Shopping ป้ายชื่อจํากัดไว้ที่ 100 ตัวอักษร | สตริง | ไม่ใช่ |
customLabel4 <custom_label_4> |
ป้ายชื่อแบบกําหนดเอง 4 ซึ่งใช้เพื่อกรองผลิตภัณฑ์สําหรับแคมเปญ Microsoft Shopping ป้ายชื่อจํากัดไว้ที่ 100 ตัวอักษร | สตริง | ไม่ใช่ |
คำ อธิบาย <คำ อธิบาย> |
คําอธิบายของผลิตภัณฑ์ คําอธิบายอาจไม่รวมข้อความส่งเสริมการขาย คําอธิบายจะถูกจํากัดไว้ที่ไม่เกิน 10,000 อักขระ และอาจมีอักขระ Unicode ใดๆ ก็ได้ คําอธิบายจะได้รับการตรวจสอบโดยบรรณาธิการ |
สตริง | ไม่ใช่ |
จุดหมาย ปลาย ทาง <ปลาย ทาง> |
ปลายทางที่ตั้งใจไว้ของผลิตภัณฑ์ MMC ไม่ได้ใช้เขตข้อมูลนี้ ซึ่งรวมอยู่ในความเข้ากันได้ของ Google |
ProductDestination[] | ไม่ใช่ |
energyEfficiencyClass <energy_efficiency_class> |
ระดับประสิทธิภาพการใช้พลังงานตามที่กําหนดไว้ในคําสั่ง EU 2010/30/EU ต่อไปนี้คือค่าที่เป็นไปได้
|
สตริง | ไม่ใช่ |
expirationDate <expiration_date> |
วันที่และเวลา UTC ที่ระบุว่าผลิตภัณฑ์จะหมดอายุเมื่อใด หากคุณไม่ได้ระบุวันหมดอายุ ผลิตภัณฑ์จะหมดอายุภายใน 30 วันนับจากวันที่และเวลาที่คุณเพิ่มหรืออัปเดตผลิตภัณฑ์ (วันที่และเวลาจะยึดตามโซนเวลาของ Microsoft Server) ใช้ฟิลด์นี้เพื่อระบุวันหมดอายุซึ่งน้อยกว่า 30 วันนับจากวันนี้ วันหมดอายุของคุณควรมีคอมโพเนนต์เวลาและระบุข้อมูลโซนเวลาหรือค่าชดเชยเสมอ ถ้าไม่เป็นเช่นนั้น API จะพยายามกําหนดโซนเวลาโดยใช้ targetCountry สําหรับประเทศหรือภูมิภาคที่มีหลายโซนเวลา API จะกําหนดโซนเวลาที่จะใช้ ตัวอย่างเช่น ถ้าประเทศเป็นสหรัฐอเมริกา API จะใช้เวลามาตรฐานแปซิฟิก (PST) คุณควรติดตามผลิตภัณฑ์ที่ใกล้หมดอายุและก่อนที่ผลิตภัณฑ์จะหมดอายุให้อัปเดตวันหมดอายุหรืออัปเดตเพียงผลิตภัณฑ์ (คุณไม่จําเป็นต้องอัปเดตเขตข้อมูลของผลิตภัณฑ์) ซึ่งจะขยายวันหมดอายุโดยอัตโนมัติอีก 30 วัน ถ้าคุณกําหนดวันหมดอายุอย่างชัดเจน การอัปเดตผลิตภัณฑ์จะไม่ขยายวันหมดอายุโดยอัตโนมัติอีก 30 วันในกรณีนี้ |
สตริง | ไม่ใช่ |
เพศ <เพศ> |
เพศที่ผลิตภัณฑ์กําหนดเป้าหมาย ต่อไปนี้คือค่าที่เป็นไปได้
|
สตริง | ไม่ใช่ |
googleProductCategory <google_product_category> |
ประเภทผลิตภัณฑ์ที่พบผลิตภัณฑ์ คุณอาจระบุสตริงประเภท (ตัวอย่างเช่น สัตว์ & วัสดุบรรจุ > สัตว์เลี้ยงสําหรับ > สัตว์เลี้ยง) หรือ ID ประเภท (ตัวอย่างเช่น 3) สําหรับสตริงประเภท รายการประเภทย่อยจะถูกคั่นด้วยเครื่องหมายมากกว่า (''>) เขตข้อมูลจะถูกจํากัดไว้ที่ 255 อักขระ สําหรับรายการของสตริงประเภทและ ID ดูหมวดหมู่ |
สตริง | ไม่ใช่ |
gtin <gtin> |
หมายเลขสินค้าการค้าสากล (GTIN) ที่กําหนดโดยผู้ผลิต หากผู้ผลิตกําหนด GTIN คุณต้องระบุ GTIN นั้น ต่อไปนี้เป็น GTIN ชนิดต่างๆ
|
สตริง | ใช่ |
Id <Id> |
รหัสผลิตภัณฑ์ที่มีคุณสมบัติครบถ้วน ID เป็นส่วนประกอบของช่องเนื้อหาภาษาเป้าหมายประเทศ และ offerId ID ต้องตรงตามตัวพิมพ์ใหญ่-เล็ก ใช้ ID นี้เพื่อรับหรือลบผลิตภัณฑ์ |
สตริง | ไม่ใช่ |
identifierExists <identifier_exists> |
ค่าบูลีนที่กําหนดว่าข้อเสนอของผลิตภัณฑ์ระบุ ตัวระบุ gtinmpn หรือ แบรนด์ หรือไม่ ค่าเริ่มต้นเป็นจริง ตั้งค่าเป็น false ถ้าคุณไม่ได้ระบุตัวระบุทั้งสามตัว ตัวระบุผลิตภัณฑ์ที่ไม่ซ้ํากันจะกําหนดผลิตภัณฑ์ใน Marketplace ส่วนกลาง การแท็กผลิตภัณฑ์ของคุณด้วยตัวระบุที่ไม่ซ้ํากันช่วยให้ลูกค้าค้นหาผลิตภัณฑ์ของคุณได้ง่ายขึ้น คุณควรระบุตัวระบุทั้งสามตัว ถ้าทราบ |
บูลีน | ไม่ใช่ |
imageLink <image_link> |
URL ไปยังรูปภาพของผลิตภัณฑ์ที่สามารถใช้ในโฆษณาผลิตภัณฑ์ได้ URL จะถูกจํากัดไว้ที่ 1,000 อักขระ และอาจใช้โพรโทคอล HTTP หรือ HTTPS ชนิดของรูปภาพที่ได้รับอนุญาตคือ bmp, gif, exif, jpg, png และ tiff ขนาดรูปภาพที่แนะนําคือ 200x200 พิกเซล รูปภาพต้องไม่เกิน 3.9 เมกะไบต์ รูปภาพจะถูกตรวจสอบโดยบรรณาธิการ |
สตริง | ใช่ |
isBundle <is_bundle> |
ค่าบูลีนที่กําหนดว่าผลิตภัณฑ์เป็นกลุ่มสินค้าที่กําหนดโดยผู้ขายหรือไม่ ค่าเป็น true ถ้าผลิตภัณฑ์เป็นกลุ่ม | บูลีน | ไม่ใช่ |
itemGroupId <item_group_id> |
รหัสที่สามารถใช้เพื่อจัดกลุ่มตัวแปรทั้งหมดของผลิตภัณฑ์เดียวกันได้ ตัวอย่างเช่น ถ้าชุดมีให้เลือก 3 สี คุณสามารถสร้างผลิตภัณฑ์สําหรับแต่ละสีและใช้ ID นี้เพื่อจัดกลุ่ม โดยทั่วไปแล้ว คุณจะจัดกลุ่มรายการที่แตกต่างกันตามสี วัสดุ รูปแบบ หรือขนาด ID ต้องไม่ซ้ํากันภายในแค็ตตาล็อก และจํากัดไว้ที่ 50 อักขระ |
สตริง | ไม่ใช่ |
ชนิด <ชนิด> |
ชนิดของวัตถุ ฟิลด์นี้ถูกตั้งค่าเป็นcontent#product |
สตริง | ไม่ใช่ |
เชื่อม โยง <เชื่อม โยง> |
URL ไปยังหน้าของผลิตภัณฑ์บนเว็บไซต์ของคุณ URL จะถูกจํากัดไว้ที่ 2,000 อักขระ และอาจใช้โพรโทคอล HTTP หรือ HTTPS โดเมนต้องตรงกับโดเมนของร้านค้า ลิงก์ถูกใช้ในโฆษณาผลิตภัณฑ์ อาจไม่มีการเปลี่ยนเส้นทาง URL หากต้องการใช้ URL อื่นในโฆษณาผลิตภัณฑ์ที่อาจเปลี่ยนเส้นทางไปยัง URL นี้ โปรดดู adwordsRedirect เว็บเพจที่ลิงก์นี้ชี้ไปจะได้รับการตรวจสอบโดยบรรณาธิการ |
สตริง | ใช่ |
วัสดุ <วัสดุ> |
วัสดุเด่นของผลิตภัณฑ์ หากวัสดุผสมกันระหว่างวัสดุคุณสามารถระบุรายการคั่นด้วยเครื่องหมายทับได้สูงสุด 3 วัสดุ (ตัวอย่างเช่นหนัง / หนังเทียม / ผ้าไหม) หากชุดมีให้เลือกหลายวัสดุ คุณจะสร้างผลิตภัณฑ์สําหรับแต่ละวัสดุและใช้ itemGroupId เพื่อจัดกลุ่มตัวแปรของผลิตภัณฑ์ เขตข้อมูลจะถูกจํากัดไว้ที่ 200 อักขระ แนะนําสําหรับรายการเครื่องแต่งกาย |
สตริง | ไม่ใช่ |
mobileLink <mobile_link> |
URL ไปยังเว็บเพจที่ปรับให้เหมาะสมกับโทรศัพท์มือถือที่มีข้อมูลเกี่ยวกับผลิตภัณฑ์ (ดู ลิงก์) | สตริง | ไม่ใช่ |
multipack <multipack> |
จํานวนผลิตภัณฑ์ที่เหมือนกันที่ขายเป็นหน่วยเดียว (ตัวอย่างเช่น 4 ไฟฉาย) เมื่อตั้งค่าราคา ราคาดังกล่าวต้องเป็นราคา รวม ของคูณ | จํานวนเต็ม | ไม่ใช่ |
Mpn <Mpn> |
หมายเลขชิ้นส่วนของผู้ผลิต (MPN) ของผลิตภัณฑ์ หากผู้ผลิตกําหนด MPN คุณต้องระบุ MPN นั้น MPN จํากัดไว้ที่ 70 ตัวอักษร | สตริง | ใช่ |
offerId <offer_id> |
ID ที่ผู้ใช้กําหนดเองของผลิตภัณฑ์ที่กําลังเสนอ รหัสข้อเสนอไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก และต้องไม่ซ้ํากันภายในแค็ตตาล็อก และจํากัดไว้ที่ไม่เกิน 50 อักขระ เนื่องจากรหัสข้อเสนอถูกใช้เพื่อสร้าง รหัสผลิตภัณฑ์ คุณจึงไม่สามารถเปลี่ยนแปลงเขตข้อมูลนี้ได้หลังจากเพิ่มผลิตภัณฑ์ไปยังร้านค้าแล้ว |
สตริง | ใช่ |
onlineOnly <online_only> |
ค่าบูลีนที่กําหนดว่าผลิตภัณฑ์พร้อมใช้งานสําหรับการซื้อออนไลน์เท่านั้นหรือไม่ ค่าเป็น true ถ้าผลิตภัณฑ์พร้อมใช้งานทางออนไลน์เท่านั้น ค่าเริ่มต้นคือ เท็จ | บูลีน | ไม่ใช่ |
รูป แบบ <รูป แบบ> |
รูปแบบหรือการพิมพ์กราฟิกของผลิตภัณฑ์ (ตัวอย่างเช่น ลายสก็อต) รูปแบบถูกจํากัดไว้ที่ 100 อักขระ ถ้าชุดมีให้เลือกหลายรูปแบบ คุณจะสร้างผลิตภัณฑ์สําหรับแต่ละรูปแบบ และใช้ itemGroupId เพื่อจัดกลุ่มตัวเลือกของผลิตภัณฑ์ แนะนําสําหรับรายการเครื่องแต่งกาย |
สตริง | ไม่ใช่ |
ราคา <ราคา> |
ราคาของผลิตภัณฑ์ ระบุราคาในสกุลเงินของประเทศเป้าหมาย สําหรับข้อมูลว่าจะรวมภาษีในราคาหรือไม่ ดูนโยบายภาษีของแค็ตตาล็อก Microsoft Merchant Center ราคาต้องตรงกับราคาที่แสดงบนหน้าเว็บของผลิตภัณฑ์ (ดู ลิงก์) และต้องอยู่ในช่วง 0.01 (1 เซนต์) ถึง 10000000.00 (10 ล้าน) อย่างไรก็ตาม ถ้าตรงตามเงื่อนไขต่อไปนี้ คุณอาจตั้งค่าราคาเป็น 0.0 (ศูนย์) 1. เขตข้อมูล googleProductCategory ถูกตั้งค่าเป็นหนึ่งในหมวดหมู่ต่อไปนี้: - โทรศัพท์มือถือสื่อสาร>>อิเล็กทรอนิกส์> - คอมพิวเตอร์แท็บเล็ตคอมพิวเตอร์>อิเล็กทรอนิกส์> 2. เขตข้อมูล ชื่อเรื่อง ประกอบด้วยคําสําคัญคําใดคําหนึ่งต่อไปนี้: -สัญญา -งวด -เช่า -ชำระ คําหลักด้านบนแสดงเป็นภาษาอังกฤษ อย่างไรก็ตาม ชื่อเรื่องและคําสําคัญต้องอยู่ในภาษาของตลาดที่ระบุ โดยทั่วไปชื่อเรื่องจะประกอบด้วยการใช้ถ้อยคํา เช่น "... มีแผนผ่อนชําระ" หรือ "... ด้วยสัญญาเท่านั้น" คําสําคัญในสัญญาอาจใช้ได้ในทุกตลาด อย่างไรก็ตาม การผ่อนชําระ และการเช่าอาจใช้ได้เฉพาะในตลาดสหรัฐอเมริกาเท่านั้น |
ProductPrice | ใช่ |
productType <product_type> |
ประเภทผลิตภัณฑ์ที่ผู้ลงโฆษณากําหนดซึ่งอาจแตกต่างจากgoogleProductCategory ตัวอย่างเช่นสัตว์ & อุปกรณ์ > สัตว์เลี้ยงส่ง > เสบี > ยงสัตว์สัตว์ รายการของประเภทย่อยจะถูกคั่นด้วยเครื่องหมายมากกว่าสัญลักษณ์ (''>) เขตข้อมูลจะถูกจํากัดไว้ที่ 750 อักขระคุณสามารถระบุสตริงประเภทหลายรายการที่คั่นด้วยเครื่องหมายจุลภาค ตัวอย่างเช่นเครื่องแต่งกาย & อุปกรณ์เสริม > วิกอุปกรณ์ > หมวก Wig, เครื่องแต่งกาย & อุปกรณ์เสริม >> Wig กาววิกอุปกรณ์ |
สตริง | ไม่ใช่ |
รหัสโปรโมชัน <promotion_id> |
รายการรหัสที่คั่นด้วยจุลภาคที่ระบุการส่งเสริมการขายในฟีดโปรโมชันของคุณ คุณสามารถระบุรหัสโปรโมชั่นได้สูงสุด 10 รหัส ID ต้องมีอักขระอย่างน้อย 1 ตัวและไม่เกิน 60 อักขระ อักขระที่อนุญาตคืออักขระพยัญชนะผสมตัวเลข เส้นประ (-) และเครื่องหมายขีดล่าง (_) ID ทั้งหมดสําหรับตลาด (ดู เนื้อหาภาษา และ targetCountry) ต้องไม่ซ้ํากัน ตัวอย่างเช่นภายในตลาดคุณไม่สามารถใช้ PROMO1 และ promo1 แต่คุณสามารถใช้ PROMO1 ในตลาด en-US และ promo1 ในตลาด en-GB คุณอาจระบุรหัสโปรโมชันที่ไม่ซ้ํากันบนผลิตภัณฑ์อย่างน้อยหนึ่งรายการ Microsoft จะเลื่อนระดับผลิตภัณฑ์หาก ID ที่คุณระบุตรงกับรหัสโปรโมชันในฟีดโปรโมชันของคุณ (สําหรับประเทศเป้าหมายเดียวกัน) รหัสตรงกันเฉพาะเมื่อปลอกเหมือนกันเท่านั้น ตัวอย่างเช่น ID ตรงกันถ้า ID ของผลิตภัณฑ์คือ PROMO1 และ ID ของฟีดคือ PROMO1 แต่ไม่ตรงกันถ้า ID ของฟีดคือ Promo1 เพื่อให้มั่นใจว่าผลิตภัณฑ์ไม่ได้ถูกเลื่อนตําแหน่งโดยไม่ได้ตั้งใจในอนาคตคุณควรลบรหัสของโปรโมชั่นที่สิ้นสุดแล้ว แม้ว่า ID จะไม่สามารถใช้ได้อีกครั้งในฟีดโปรโมชันเป็นเวลา 6 เดือนหลังจากที่โปรโมชันสิ้นสุดลง แต่หากมีการใช้ ID ซ้ําในโปรโมชันอื่นหลังจากนั้น ผลิตภัณฑ์จะถูกเลื่อนระดับ |
สตริง | ไม่ใช่ |
salePrice <sale_price> |
ราคาขายของสินค้า ราคาขายต้องอยู่ในช่วง 0.01 (1 เซนต์) ถึง 10000000.00 (10 ล้าน) สําหรับรายการขาย ให้ตั้งค่าทั้งราคาขายและวันที่มีผลการขาย (ดู salePriceEffectiveDate ) ถ้าคุณตั้งค่าราคาขายแต่ไม่ใช่วันที่มีผลบังคับใช้ราคาขาย ราคาขายจะยังคงใช้ต่อไปจนกว่าผลิตภัณฑ์จะหมดอายุ หรือคุณกําหนดวันที่มีผลบังคับใช้ถ้าตรงตามเงื่อนไขต่อไปนี้ คุณสามารถตั้งค่าราคาขายเป็น 0.0 (ศูนย์) 1. เขตข้อมูล googleProductCategory ถูกตั้งค่าเป็นหนึ่งในหมวดหมู่ต่อไปนี้: - โทรศัพท์มือถือสื่อสาร>>อิเล็กทรอนิกส์> - คอมพิวเตอร์แท็บเล็ตคอมพิวเตอร์>อิเล็กทรอนิกส์> 2. เขตข้อมูล ชื่อเรื่อง ประกอบด้วยคําสําคัญคําใดคําหนึ่งต่อไปนี้: -สัญญา -งวด -เช่า -ชำระ คําหลักด้านบนแสดงเป็นภาษาอังกฤษ อย่างไรก็ตาม ชื่อเรื่องและคําสําคัญต้องอยู่ในภาษาของตลาดที่ระบุ โดยทั่วไปชื่อเรื่องจะประกอบด้วยการใช้ถ้อยคํา เช่น "... มีแผนผ่อนชําระ" หรือ "... ด้วยสัญญาเท่านั้น" คําสําคัญในสัญญาอาจใช้ได้ในทุกตลาด อย่างไรก็ตาม การผ่อนชําระ และการเช่าอาจใช้ได้เฉพาะในตลาดสหรัฐอเมริกาเท่านั้น |
ProductPrice | ไม่ใช่ |
salePriceEffectiveDate <sale_price_effective_date> |
วันที่เริ่มต้นและวันที่สิ้นสุด UTC ของการขาย ระบุวันที่ในรูปแบบ ISO 8601 ตัวอย่างเช่น 2016-04-05T08:00-08:00/2016-04-10T19:30-08:00 (ใช้เครื่องหมายทับ ('/') เพื่อแยกวันที่เริ่มต้นและวันที่สิ้นสุด) สําหรับข้อมูลเพิ่มเติม ให้ดูที่salePrice |
สตริง | ไม่ใช่ |
sellerName <seller_name> |
ชื่อของผู้ขายที่ขายผลิตภัณฑ์ ใช้โดยตัวรวมเท่านั้นเพื่อระบุผู้ขาย Aggregators เป็นเว็บไซต์ของบุคคลที่สามที่ทํางานในนามของผู้ค้ารายบุคคล ผลิตภัณฑ์ที่ผู้รวมส่งในนามของผู้ขายต้องสอดคล้องกับนโยบายการโฆษณาของ Microsoft และข้อกําหนดการให้บริการ ตัวรวมต้องตั้งค่าเขตข้อมูลนี้เป็นชื่อผู้ขาย ถ้าผู้เรียกไม่ใช่ตัวรวมและไม่ได้ตั้งค่าเขตข้อมูลนี้ ชื่อร้านค้าจะเป็นค่าเริ่มต้น ชื่อถูกจํากัดไว้ที่ 255 อักขระ |
สตริง | ไม่ใช่ |
จัด ส่ง <จัด ส่ง> |
ราคาที่จะจัดส่งผลิตภัณฑ์ตามตําแหน่งที่ตั้ง หมายเหตุ: ต้องมีการจัดส่งหากประเทศเป้าหมายคือ DE (เยอรมนี); มิฉะนั้น จะเลือกหรือไม่ก็ได้ |
ProductShipping[] | ใช่ |
shippingLabel <shipping_label> |
ใบจ่าหน้าสําหรับการจัดส่ง หมายเหตุ: จําเป็นต้องใช้ข้อมูลการจัดส่งหากประเทศเป้าหมายคือ DE (เยอรมนี); มิฉะนั้น จะเลือกหรือไม่ก็ได้ |
สตริง | ใช่ |
shippingweight <shipping_weight> |
น้ําหนักของผลิตภัณฑ์ น้ําหนักจะใช้สําหรับวัตถุประสงค์ในการจัดส่ง หมายเหตุ: จําเป็นต้องใช้ข้อมูลการจัดส่งหากประเทศเป้าหมายคือ DE (เยอรมนี); มิฉะนั้น จะเลือกหรือไม่ก็ได้ |
ProductShippingWeight | ใช่ |
ขนาด <ขนาด> |
ขนาดของผลิตภัณฑ์ที่พร้อมใช้งาน ตัวอย่างเช่น ขนาดเล็ก กลาง และใหญ่ นําการปรับขนาดไปใช้อย่างสม่ําเสมอ ค่าขนาดเป็นค่าที่ผู้ใช้กําหนดเอง แต่ควรยึดตามประเทศเป้าหมายของคุณ เขตข้อมูลนี้จําเป็นสําหรับผลิตภัณฑ์อุปกรณ์เสริม & เครื่องแต่งกายทั้งหมดเมื่อกําหนดเป้าหมาย: ฝรั่งเศส เยอรมนี สหราชอาณาจักร และสหรัฐอเมริกา | String[] | ไม่ใช่ |
sizeSystem <size_system> |
ระบบการวัดที่ใช้ในการปรับขนาดผลิตภัณฑ์ ตัวอย่างเช่น รองเท้าอาจมีขนาดตามระบบของสหรัฐอเมริกาหรือระบบของสหราชอาณาจักร ต่อไปนี้คือค่าที่เป็นไปได้
|
สตริง | ไม่ใช่ |
sizeType <size_type> |
การตัดผลิตภัณฑ์ ต่อไปนี้คือค่าที่เป็นไปได้
|
สตริง | ไม่ใช่ |
targetCountry <target_country> |
รหัสประเทศ ISO 3166 สองตัวอักษรของประเทศเป้าหมาย (ประเทศที่คุณต้องการโฆษณาผลิตภัณฑ์) ประเทศต้องตรงกับตลาดที่ระบุโดยแค็ตตาล็อก ต่อไปนี้คือค่าที่ไม่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้:
|
สตริง | ใช่ |
ภาษี <ภาษี> |
ข้อมูลภาษีของผลิตภัณฑ์ MMC ไม่ได้ใช้เขตข้อมูลนี้ ซึ่งรวมอยู่ในความเข้ากันได้ของ Google |
ProductTax[] | ไม่ใช่ |
ชื่อ เรื่อง <ชื่อ เรื่อง> |
ชื่อผลิตภัณฑ์ (ตัวอย่างเช่น รองเท้าผู้หญิง) ชื่อเรื่องต้องไม่มีข้อความส่งเสริมการขาย ชื่อเรื่องจะถูกจํากัดไว้ที่อักขระไม่เกิน 150 ตัว และอาจมีอักขระ Unicode ใดๆ ก็ได้ ชื่อเรื่องจะถูกตรวจสอบโดยบรรณาธิการ |
สตริง | ใช่ |
unitPricingBaseMeasure <unit_pricing_base_measure> |
หน่วยวัดพื้นฐานของผลิตภัณฑ์สําหรับการกําหนดราคา (ตัวอย่างเช่น 100ml หมายถึงราคาคํานวณจากหน่วย 100ml)
|
UnitPricingBaseMeasure | ไม่ใช่ |
unitPricingMeasure <unit_pricing_measure> |
หน่วยวัดและขนาดของผลิตภัณฑ์ตามที่ขายได้
|
UnitPricingMeasure | ไม่ใช่ |
validatedDestinations <validated_destination> |
รายการแบบอ่านอย่างเดียวของปลายทางที่ต้องการซึ่งผ่านการตรวจสอบความถูกต้องแล้ว MMC ไม่ได้ใช้เขตข้อมูลนี้ ซึ่งรวมอยู่ในความเข้ากันได้ของ Google |
String[] | ไม่ใช่ |
คำ เตือน | รายการคําเตือนเกี่ยวกับปัญหาเกี่ยวกับข้อเสนอผลิตภัณฑ์ ข้อเสนอได้รับการยอมรับ แต่คุณควรแก้ไขปัญหาตามความสะดวกแรกสุดของคุณ ตัวอย่างเช่น MMC จะส่งกลับคําเตือนหากคุณไม่ได้ระบุ ตัวระบุ gtin, mpn และ brand หากควรทราบ ข้อเสนอรวมถึงเขตข้อมูลนี้เฉพาะในการตอบกลับการแทรก/ปรับปรุง |
คําเตือน[] | ไม่ใช่ |
ProductCustomAttribute
กําหนดแอตทริบิวต์แบบกําหนดเอง
ชื่อ | ค่า | ชนิด | ชื่อองค์ประกอบ XML |
---|---|---|---|
ชื่อ | รับหรือตั้งชื่อแอตทริบิวต์ | สตริง | <ชื่อ> |
ชนิด | รับหรือตั้งค่าชนิดของแอตทริบิวต์ ต่อไปนี้คือค่าที่เป็นไปได้
|
สตริง | <ชนิด> |
หน่วย | รับหรือตั้งค่าหน่วยวัดของแอตทริบิวต์ ใช้สําหรับค่าชนิด INT และ FLOAT เท่านั้น | สตริง | <หน่วย> |
ค่า | รับหรือตั้งค่าของแอตทริบิวต์ | สตริง | <ค่า> |
ProductCustomGroup
กําหนดกลุ่มของแอตทริบิวต์ลูกค้า
ชื่อ | ค่า | ชนิด | ชื่อองค์ประกอบ XML |
---|---|---|---|
แอ ตทริ บิวต์ | รับหรือตั้งค่าแอตทริบิวต์สําหรับกลุ่ม | ProductCustomAttribute | <แอ ตทริ บิวต์> |
ชื่อ | รับหรือตั้งชื่อกลุ่ม | สตริง | <ชื่อ> |
ProductDestination
กําหนดปลายทาง
ชื่อ | ค่า | ชนิด | ชื่อองค์ประกอบ XML |
---|---|---|---|
เจตนา | ต่อไปนี้คือค่าที่เป็นไปได้
|
สตริง | <เจตนา> |
destinationName | รับหรือตั้งชื่อปลายทาง | สตริง | <destination_name> |
ProductPrice
กําหนดราคาหรือราคาขายของผลิตภัณฑ์
ชื่อ | ค่า | ชนิด | ชื่อองค์ประกอบ XML |
---|---|---|---|
สกุล เงิน | รับหรือตั้งค่าสกุลเงินที่ระบุราคา ระบุสกุลเงินโดยใช้รหัสสกุลเงิน ISO 4217 ต่อไปนี้คือค่าที่เป็นไปได้
|
สตริง |
currency แอ ตทริ บิวต์ ตัวอย่างเช่น <สกุลเงินของราคา="USD"> |
ค่า | รับหรือตั้งค่าราคาของสินค้า ไม่ต้องใส่สัญลักษณ์สกุลเงิน เช่น '$' | คู่ | ค่าข้อความ ตัวอย่างเช่น <สกุลเงินราคา="USD">38.0<\price> |
ผลิตภัณฑ์
กําหนดรายการผลิตภัณฑ์ โปรดทราบว่า นี่เป็นออบเจ็กต์ระดับบนสุดที่คําขอรายการส่งกลับ
ชื่อ | ค่า | ชนิด | ชื่อองค์ประกอบ XML |
---|---|---|---|
ชนิด | รับชนิดของวัตถุ เขตข้อมูลนี้ถูกตั้งค่าเป็น content#productsListResponse | สตริง | <ชนิด> |
nextPageToken | รับโทเค็นที่ใช้ในการรับหน้าผลลัพธ์ถัดไป ถ้าวัตถุไม่รวมเขตข้อมูลนี้ จะไม่มีหน้าที่จะรับอีก ดูโทเค็นเริ่มต้น | สตริง | <next_page_token> |
ทรัพยากร | รับรายการผลิตภัณฑ์ หากแค็ตตาล็อกไม่มีข้อเสนอใด ๆ อาร์เรย์จะว่างเปล่า | ผลิตภัณฑ์[] | <ผลิตภัณฑ์> |
ProductShipping
กําหนดต้นทุนการจัดส่ง
ชื่อ | ค่า | ชนิด | ชื่อองค์ประกอบ XML |
---|---|---|---|
ประเทศ | รับหรือตั้งค่ารหัสประเทศ ISO 3166 สองตัวอักษรของประเทศที่จัดส่งสินค้าไป | สตริง | <ประเทศ> |
locationGroupName | รับหรือตั้งชื่อกลุ่มตําแหน่งที่ตั้ง | สตริง | <location_group_name> |
locationId | รับหรือตั้งค่ารหัสของตําแหน่งที่ตั้งทางภูมิศาสตร์ที่มีการจัดส่งสินค้าไป สําหรับรายการรหัส ให้ดู รหัสที่ตั้งทางภูมิศาสตร์ | สตริง | <location_id> |
รหัสไปรษณีย์ | รับหรือตั้งค่ารหัสไปรษณีย์หรือช่วงรหัสไปรษณีย์ของที่ตั้งที่มีการจัดส่งสินค้าไปให้ คุณสามารถระบุรหัสไปรษณีย์ได้ดังนี้:
|
สตริง | <postal_code> |
ราคา | รับหรือตั้งค่าราคาคงที่เพื่อจัดส่งสินค้าไปยังตําแหน่งที่ตั้งที่ระบุ | ProductPrice | <ราคา> |
ภูมิภาค | รับหรือตั้งค่าภูมิภาคทางภูมิศาสตร์ที่จัดส่งสินค้าไป (ตัวอย่างเช่น รหัสไปรษณีย์) | สตริง | <ภูมิภาค> |
บริการ | รับหรือตั้งค่าคําอธิบายข้อความที่อธิบายคลาสบริการหรือความเร็วในการส่ง | สตริง | <บริการ> |
ProductShippingWeight
กําหนดน้ําหนักการจัดส่งของสินค้า
ชื่อ | ค่า | ชนิด | ชื่อองค์ประกอบ XML |
---|---|---|---|
หน่วย | รับหรือตั้งค่าหน่วยวัด | สตริง |
unit แอ ตทริ บิวต์ ตัวอย่างเช่น <shipping_weight unit="oz"> |
ค่า | รับหรือตั้งค่าน้ําหนักของสินค้า ซึ่งใช้ในการคํานวณต้นทุนการจัดส่งของสินค้า | สตริง | ค่าข้อความ ตัวอย่างเช่น <shipping_weight unit="oz">20.3<shipping_weight> |
ProductTax
กําหนดตําแหน่งที่ตั้งทางภูมิศาสตร์ที่กําหนดภาษีที่เกี่ยวข้อง
ชื่อ | ค่า | ชนิด | ชื่อองค์ประกอบ XML |
---|---|---|---|
ประเทศ | รับหรือตั้งค่าประเทศที่ใช้อัตราภาษี ใช้รหัสประเทศ ISO 3166 แบบสองตัวอักษร | สตริง | <ประเทศ> |
locationId | รับหรือตั้งค่ารหัสของตําแหน่งที่ตั้งทางภูมิศาสตร์ที่ใช้อัตราภาษี สําหรับรายการรหัส ให้ดู รหัสที่ตั้งทางภูมิศาสตร์ | ยาว | <location_id> |
รหัสไปรษณีย์ | รับหรือตั้งค่ารหัสไปรษณีย์หรือช่วงของรหัสไปรษณีย์ที่ใช้อัตราภาษี คุณสามารถระบุรหัสไปรษณีย์ได้ดังนี้:
|
สตริง | <postal_code> |
อัตรา | รับหรือตั้งค่าอัตราภาษีเปอร์เซ็นต์ที่จะใช้กับราคาของรายการ เมื่อต้องการระบุอัตรา 5% ให้ตั้งค่าเขตข้อมูลนี้เป็น 5 เมื่อต้องการระบุอัตรา 9.8% ให้ตั้งค่าเขตข้อมูลนี้เป็น 9.8 | คู่ | <อัตรา> |
ภูมิภาค | รับหรือตั้งค่าภูมิภาคทางภูมิศาสตร์ที่ใช้อัตราภาษี | สตริง | <ภูมิภาค> |
taxShip | รับหรือตั้งค่าบูลีนที่กําหนดว่าจะนําภาษีไปใช้กับค่าจัดส่งหรือไม่ ตั้งค่าเป็น true ถ้ามีการเรียกเก็บภาษีในการจัดส่ง | บูลีน | <เรือ> |
UnitPricing
กําหนดสินค้าต่อราคาต่อหน่วย
ชื่อ | ค่า | ชนิด | ชื่อองค์ประกอบ XML |
---|---|---|---|
หน่วย | รับหรือตั้งค่าหน่วยวัด ตัวอย่างเช่น ออนซ์ ถ้าราคาต่อออนซ์ | สตริง |
unit แอ ตทริ บิวต์ ตัวอย่างเช่น <unit_pricing_measure unit="oz"> |
ค่า | รับหรือตั้งค่าราคาต่อหน่วย | คู่ | ค่าข้อความ ตัวอย่างเช่น <หน่วย unit_pricing_measure="oz">34.5<\unit_pricing_measure> |
คำเตือน
กําหนดข้อความเตือน
ชื่อ | ค่า | ชนิด | ชื่อองค์ประกอบ XML |
---|---|---|---|
โด เมน | สําหรับใช้ภายในเท่านั้น | สตริง | <โด เมน> |
ข้อความ | คําอธิบายของคําเตือน | สตริง | <internalReason> |
เหตุผล | เหตุผลที่ข้อเสนอสร้างคําเตือน ตัวอย่างเช่น คุณไม่ได้ระบุตัวระบุ (gtin, mpn หรือ แบรนด์) เมื่อผู้ผลิตทราบว่ามีการกําหนดตัวระบุดังกล่าว | สตริง | <เหตุผล> |
รหัสสถานะ HTTP
คําขออาจส่งกลับรหัสสถานะ HTTP ต่อไปนี้
รหัสสถานะ | คำอธิบาย |
---|---|
200 | สำเร็จ |
204 | ลบผลิตภัณฑ์สําเร็จแล้ว |
400 | การร้องขอไม่ถูกต้อง ค่าพารามิเตอร์คิวรีไม่ถูกต้องหรือบางอย่างในเนื้อความของการร้องขอไม่ถูกต้อง ชุดงาน: ถ้าเกิดข้อผิดพลาด สินค้าชุดงานที่ล้มเหลวจะรวมข้อผิดพลาดไว้ด้วย |
401 | ไม่ได้รับอนุญาต ข้อมูลประจําตัวของผู้ใช้ไม่ถูกต้อง |
404 | ไม่พบ |
409 | ขัดแย้งกัน ไม่สามารถดําเนินการให้เสร็จสมบูรณ์ได้ เนื่องจากมีข้อขัดแย้งกับสถานะปัจจุบันของทรัพยากร |
413 | ร้องขอเอนทิตีมากเกินไป การร้องขอมีขนาดเกินกว่าขนาดสูงสุดที่อนุญาต |
500 | ข้อผิดพลาดที่เซิร์ฟเวอร์ |