ทรัพยากรผลิตภัณฑ์

ทรัพยากรผลิตภัณฑ์ช่วยให้คุณสามารถจัดการข้อเสนอผลิตภัณฑ์ใน 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	เสริม ใช้เพื่อระบุแค็ตตาล็อกเพื่อแทรกข้อเสนอผลิตภัณฑ์ (อัปเดต) ใช้พารามิเตอร์นี้ถ้าร้านค้าของคุณประกอบด้วยหลายแค็ตตาล็อก ถ้าคุณไม่ได้ระบุพารามิเตอร์นี้ ผลิตภัณฑ์จะถูกแทรกลงในแค็ตตาล็อกเริ่มต้นของร้านค้า พารามิเตอร์นี้ใช้เพื่อแทรกข้อเสนอผลิตภัณฑ์เท่านั้น พารามิเตอร์นี้ถูกละเว้นสําหรับการร้องขอรับ รายการ และลบเนื่องจากดําเนินการข้ามแค็ตตาล็อก
แห้ง- ทํางาน	เสริม ใช้เมื่อดีบักแอปพลิเคชันของคุณเพื่อทดสอบการโทร การเรียกใช้ที่รวมพารามิเตอร์นี้จะไม่ส่งผลกระทบต่อข้อมูลการผลิต (ผลิตภัณฑ์จะไม่ถูกแทรกหรือลบ) อย่างไรก็ตาม การตอบสนองจะมีข้อผิดพลาดใดๆ ที่การเรียกสร้างขึ้น พิจารณาข้อจํากัดต่อไปนี้เมื่อใช้พารามิเตอร์นี้ การแทรกการดําเนินการไม่ส่งกลับรหัส บริการไม่ได้สร้างหรือส่งกลับข้อความข้อผิดพลาดรอง เช่น คุณภาพข้อมูล ปัญหาด้านบรรณาธิการ และการตรวจสอบที่เกี่ยวข้องกับฐานข้อมูล สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการทดสอบแอปพลิเคชันของคุณ ให้ดู Sandbox
ผลลัพธ์สูงสุด	เสริม ใช้ เพื่อระบุจํานวนสูงสุดของหน่วยข้อมูลที่จะส่งกลับในการร้องขอรายการ ค่าสูงสุดที่คุณอาจระบุคือ 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 แบบสองตัวอักษรสําหรับผลิตภัณฑ์ ต่อไปนี้คือค่าที่ไม่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้: แอลเบเนีย (sq) บอสเนีย (bs) บัลแกเรีย (bg) โครเอเชีย (ชม.) เช็ก (cs) ดัตช์ (nl) อังกฤษ (en) เอสโตเนีย (et) ฝรั่งเศส (fr) เยอรมัน (de) กรีก (el) ฮังการี (hu) ไอซ์แลนด์ (คือ) ภาษาอิตาลี (it) ลัตเวีย (lv) ลิทัวเนีย (lt) มาซิโดเนีย (mk) มอลตา (mt) โปแลนด์ (pl) ภาษาโปรตุเกส (pt) โรมาเนีย (ro) ภาษาเซอร์เบีย (sr) สโลวัก (sk) สโลวีเนีย (sl) สเปน (es) สวีเดน (sv) ตุรกี (tr) เนื่องจากภาษาที่ใช้ในการสร้าง รหัสผลิตภัณฑ์ คุณจึงไม่สามารถเปลี่ยนแปลงเขตข้อมูลนี้ได้หลังจากเพิ่มผลิตภัณฑ์ลงในร้านค้าแล้ว	สตริง	ใช่
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 ต่อไปนี้คือค่าที่เป็นไปได้ A A+ A++ A+++ B C D ตะวัน ออก F กรัม	สตริง	ไม่ใช่
expirationDate <expiration_date>	วันที่และเวลา UTC ที่ระบุว่าผลิตภัณฑ์จะหมดอายุเมื่อใด หากคุณไม่ได้ระบุวันหมดอายุ ผลิตภัณฑ์จะหมดอายุภายใน 30 วันนับจากวันที่และเวลาที่คุณเพิ่มหรืออัปเดตผลิตภัณฑ์ (วันที่และเวลาจะยึดตามโซนเวลาของ Microsoft Server) ใช้ฟิลด์นี้เพื่อระบุวันหมดอายุซึ่งน้อยกว่า 30 วันนับจากวันนี้ วันหมดอายุของคุณควรมีคอมโพเนนต์เวลาและระบุข้อมูลโซนเวลาหรือค่าชดเชยเสมอ ถ้าไม่เป็นเช่นนั้น API จะพยายามกําหนดโซนเวลาโดยใช้ targetCountry สําหรับประเทศหรือภูมิภาคที่มีหลายโซนเวลา API จะกําหนดโซนเวลาที่จะใช้ ตัวอย่างเช่น ถ้าประเทศเป็นสหรัฐอเมริกา API จะใช้เวลามาตรฐานแปซิฟิก (PST) คุณควรติดตามผลิตภัณฑ์ที่ใกล้หมดอายุและก่อนที่ผลิตภัณฑ์จะหมดอายุให้อัปเดตวันหมดอายุหรืออัปเดตเพียงผลิตภัณฑ์ (คุณไม่จําเป็นต้องอัปเดตเขตข้อมูลของผลิตภัณฑ์) ซึ่งจะขยายวันหมดอายุโดยอัตโนมัติอีก 30 วัน ถ้าคุณกําหนดวันหมดอายุอย่างชัดเจน การอัปเดตผลิตภัณฑ์จะไม่ขยายวันหมดอายุโดยอัตโนมัติอีก 30 วันในกรณีนี้	สตริง	ไม่ใช่
เพศ <เพศ>	เพศที่ผลิตภัณฑ์กําหนดเป้าหมาย ต่อไปนี้คือค่าที่เป็นไปได้ หญิง ชาย Unisex	สตริง	ไม่ใช่
googleProductCategory <google_product_category>	ประเภทผลิตภัณฑ์ที่พบผลิตภัณฑ์ คุณอาจระบุสตริงประเภท (ตัวอย่างเช่น สัตว์ & วัสดุบรรจุ > สัตว์เลี้ยงสําหรับ > สัตว์เลี้ยง) หรือ ID ประเภท (ตัวอย่างเช่น 3) สําหรับสตริงประเภท รายการประเภทย่อยจะถูกคั่นด้วยเครื่องหมายมากกว่า (''>) เขตข้อมูลจะถูกจํากัดไว้ที่ 255 อักขระ สําหรับรายการของสตริงประเภทและ ID ดูหมวดหมู่	สตริง	ไม่ใช่
gtin <gtin>	หมายเลขสินค้าการค้าสากล (GTIN) ที่กําหนดโดยผู้ผลิต หากผู้ผลิตกําหนด GTIN คุณต้องระบุ GTIN นั้น ต่อไปนี้เป็น GTIN ชนิดต่างๆ EAN (หมายเลขบทความของยุโรป) ISBN (หมายเลขหนังสือมาตรฐานสากล) JAN (หมายเลขบทความภาษาญี่ปุ่น) UPC (รหัสผลิตภัณฑ์สากล)	สตริง	ใช่
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>	ระบบการวัดที่ใช้ในการปรับขนาดผลิตภัณฑ์ ตัวอย่างเช่น รองเท้าอาจมีขนาดตามระบบของสหรัฐอเมริกาหรือระบบของสหราชอาณาจักร ต่อไปนี้คือค่าที่เป็นไปได้ Th เด Fr สห ราช อาณาจักร เรา ค่าเริ่มต้นคือระบบที่ใช้โดยประเทศเป้าหมาย แนะนําสําหรับรายการเครื่องแต่งกาย	สตริง	ไม่ใช่
sizeType <size_type>	การตัดผลิตภัณฑ์ ต่อไปนี้คือค่าที่เป็นไปได้ ปกติ วันคลอด เล็ก พลัส ใหญ่และสูง ค่าเริ่มต้นเป็นปกติ แนะนําสําหรับรายการเครื่องแต่งกาย	สตริง	ไม่ใช่
targetCountry <target_country>	รหัสประเทศ ISO 3166 สองตัวอักษรของประเทศเป้าหมาย (ประเทศที่คุณต้องการโฆษณาผลิตภัณฑ์) ประเทศต้องตรงกับตลาดที่ระบุโดยแค็ตตาล็อก ต่อไปนี้คือค่าที่ไม่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้: AD (Andorra) AL (แอลเบเนีย) AR (อาร์เจนตินา) AW (อารูบา) AT (ออสเตรีย) AU (ออสเตรเลีย) BS (บาฮามาส) BD (บังกลาเทศ) BA (บอสเนียและเฮอร์เซโกวีนา) BE (เบลเยียม) BO (โบลิเวีย) BG (บัลแกเรีย) BR (บราซิล) BN (บรูไน) CA (แคนาดา) KY (หมู่เกาะเคย์แมน) CH (สวิตเซอร์แลนด์) CL (ชิลี) CO (โคลอมเบีย) CR (คอสตาริกา) ไซปรัส (ไซปรัส) CZ (สาธารณรัฐเช็ก) DE (เยอรมนี) DK (เดนมาร์ก) DM (โดมินิกา) DO (สาธารณรัฐโดมินิกัน) EC (เอกวาดอร์) SV (เอลซัลวาดอร์) EE (เอสโตเนีย) ES (สเปน) FJ (ฟิจิ) FI (ฟินแลนด์) FR (ฝรั่งเศส) GF (เฟรนช์เกียนา) PF (เฟรนช์โปลินีเซีย) GB (สหราชอาณาจักร) GR (กรีซ) GU (กวม) GT (กัวเตมาลา) GY (กายอานา) HT (เฮติ) HN (ฮอนดูรัส) HR (โครเอเชีย) HU (ฮังการี) ID (อินโดนีเซีย) IE (ไอร์แลนด์) IN (อินเดีย) IS (ไอซ์แลนด์) IT (อิตาลี) LI (ลิกเตนสไตน์) LT (ลิทัวเนีย) LU (ลักเซมเบิร์ก) LV (ลัตเวีย) MV (มัลดีฟส์) MC (โมนาโก) ME (มอนเตเนโกร) MK (นอร์ทมาซิโดเนีย) MT (มอลตา) MQ (มาร์ตินีก) MY (มาเลเซีย) MX (เม็กซิโก) MN (มองโกเลีย) MS (มอนต์เซอร์รัต) NP (เนปาล) NL (เนเธอร์แลนด์) NC (นิวแคลิโดเนีย) NO (นอร์เวย์) NZ (นิวซีแลนด์) PA (ปานามา) PG (ปาปัวนิวกินี) PH (ฟิลิปปินส์) PY (ปารากวัย) PE (เปรู) PL (โปแลนด์) PT (โปรตุเกส) PR (เปอร์โตริโก) RO (โรมาเนีย) RS (เซอร์เบีย) LK (ศรีลังกา) SE (สวีเดน) SG (สิงคโปร์) SI (สโลวีเนีย) SK (สโลวาเกีย) SM (ซานมาริโน) TH (ประเทศไทย) TT (ตรินิแดดและโตเบโก) TR (Türkiye) สหรัฐอเมริกา (สหรัฐอเมริกา) UT (อุรุกวัย) VA (นครวาติกัน) VE (เวเนซุเอลา) VN (เวียดนาม) ZA (แอฟริกาใต้) เนื่องจากประเทศถูกใช้เพื่อสร้าง รหัสผลิตภัณฑ์ คุณจึงไม่สามารถเปลี่ยนแปลงเขตข้อมูลนี้ได้หลังจากเพิ่มผลิตภัณฑ์ลงในร้านค้าแล้ว	สตริง	ใช่
ภาษี <ภาษี>	ข้อมูลภาษีของผลิตภัณฑ์ MMC ไม่ได้ใช้เขตข้อมูลนี้ ซึ่งรวมอยู่ในความเข้ากันได้ของ Google	ProductTax[]	ไม่ใช่
ชื่อ เรื่อง <ชื่อ เรื่อง>	ชื่อผลิตภัณฑ์ (ตัวอย่างเช่น รองเท้าผู้หญิง) ชื่อเรื่องต้องไม่มีข้อความส่งเสริมการขาย ชื่อเรื่องจะถูกจํากัดไว้ที่อักขระไม่เกิน 150 ตัว และอาจมีอักขระ Unicode ใดๆ ก็ได้ ชื่อเรื่องจะถูกตรวจสอบโดยบรรณาธิการ	สตริง	ใช่
unitPricingBaseMeasure <unit_pricing_base_measure>	หน่วยวัดพื้นฐานของผลิตภัณฑ์สําหรับการกําหนดราคา (ตัวอย่างเช่น 100ml หมายถึงราคาคํานวณจากหน่วย 100ml) น้ําหนัก: ออนซ์, ปอนด์, มิลลิกรัม, กรัม, กิโลกรัม ปริมาณ (อิมพีเรียลของสหรัฐอเมริกา): floz, pt, qt, gal ปริมาณ: ml, cl, l, cbm ความยาว: ใน, ฟุต, yd, cm, m พื้นที่: ตารางเมตร ต่อหน่วย: กะรัต	UnitPricingBaseMeasure	ไม่ใช่
unitPricingMeasure <unit_pricing_measure>	หน่วยวัดและขนาดของผลิตภัณฑ์ตามที่ขายได้ น้ําหนัก: ออนซ์, ปอนด์, มิลลิกรัม, กรัม, กิโลกรัม ปริมาณ (อิมพีเรียลของสหรัฐอเมริกา): floz, pt, qt, gal ปริมาณ: ml, cl, l, cbm ความยาว: ใน, ฟุต, yd, cm, m พื้นที่: ตารางเมตร ต่อหน่วย: กะรัต	UnitPricingMeasure	ไม่ใช่
validatedDestinations <validated_destination>	รายการแบบอ่านอย่างเดียวของปลายทางที่ต้องการซึ่งผ่านการตรวจสอบความถูกต้องแล้ว MMC ไม่ได้ใช้เขตข้อมูลนี้ ซึ่งรวมอยู่ในความเข้ากันได้ของ Google	String[]	ไม่ใช่
คำ เตือน	รายการคําเตือนเกี่ยวกับปัญหาเกี่ยวกับข้อเสนอผลิตภัณฑ์ ข้อเสนอได้รับการยอมรับ แต่คุณควรแก้ไขปัญหาตามความสะดวกแรกสุดของคุณ ตัวอย่างเช่น MMC จะส่งกลับคําเตือนหากคุณไม่ได้ระบุ ตัวระบุ gtin, mpn และ brand หากควรทราบ ข้อเสนอรวมถึงเขตข้อมูลนี้เฉพาะในการตอบกลับการแทรก/ปรับปรุง	คําเตือน[]	ไม่ใช่

ProductCustomAttribute

กําหนดแอตทริบิวต์แบบกําหนดเอง

ชื่อ	ค่า	ชนิด	ชื่อองค์ประกอบ XML
ชื่อ	รับหรือตั้งชื่อแอตทริบิวต์	สตริง	<ชื่อ>
ชนิด	รับหรือตั้งค่าชนิดของแอตทริบิวต์ ต่อไปนี้คือค่าที่เป็นไปได้ บูลีน datetimerange ลอย กลุ่ม Int ราคา ข้อความ เวลา Url	สตริง	<ชนิด>
หน่วย	รับหรือตั้งค่าหน่วยวัดของแอตทริบิวต์ ใช้สําหรับค่าชนิด INT และ FLOAT เท่านั้น	สตริง	<หน่วย>
ค่า	รับหรือตั้งค่าของแอตทริบิวต์	สตริง	<ค่า>

ProductCustomGroup

กําหนดกลุ่มของแอตทริบิวต์ลูกค้า

ชื่อ	ค่า	ชนิด	ชื่อองค์ประกอบ XML
แอ ตทริ บิวต์	รับหรือตั้งค่าแอตทริบิวต์สําหรับกลุ่ม	ProductCustomAttribute	<แอ ตทริ บิวต์>
ชื่อ	รับหรือตั้งชื่อกลุ่ม	สตริง	<ชื่อ>

ProductDestination

กําหนดปลายทาง

ชื่อ	ค่า	ชนิด	ชื่อองค์ประกอบ XML
เจตนา	ต่อไปนี้คือค่าที่เป็นไปได้ เริ่ม ต้น ยก เว้น เสริม ต้องระบุ	สตริง	<เจตนา>
destinationName	รับหรือตั้งชื่อปลายทาง	สตริง	<destination_name>

ProductPrice

กําหนดราคาหรือราคาขายของผลิตภัณฑ์

ชื่อ	ค่า	ชนิด	ชื่อองค์ประกอบ XML
สกุล เงิน	รับหรือตั้งค่าสกุลเงินที่ระบุราคา ระบุสกุลเงินโดยใช้รหัสสกุลเงิน ISO 4217 ต่อไปนี้คือค่าที่เป็นไปได้ AUD (ดอลลาร์ออสเตรเลีย) CHF (ฟรังก์สวิส) CAD (ดอลลาร์แคนาดา) EUR (ยูโร) GBP (ปอนด์บริเตนใหญ่) IDR (รูเปียห์อินโดนีเซีย) INR (รูปี อินเดีย) MYR (ริงกิตมาเลเซีย) NZD (ดอลลาร์นิวซีแลนด์) PHP (เปโซฟิลิปปินส์) SEK (โครนาสวีเดน) SGD (ดอลลาร์สิงคโปร์) บาท (บาท) USD (ดอลลาร์สหรัฐ) VND (ดองเวียดนาม)	สตริง	currency แอ ตทริ บิวต์ ตัวอย่างเช่น <สกุลเงินของราคา="USD">
ค่า	รับหรือตั้งค่าราคาของสินค้า ไม่ต้องใส่สัญลักษณ์สกุลเงิน เช่น '$'	คู่	ค่าข้อความ ตัวอย่างเช่น <สกุลเงินราคา="USD">38.0<\price>

ผลิตภัณฑ์

กําหนดรายการผลิตภัณฑ์ โปรดทราบว่า นี่เป็นออบเจ็กต์ระดับบนสุดที่คําขอรายการส่งกลับ

ชื่อ	ค่า	ชนิด	ชื่อองค์ประกอบ XML
ชนิด	รับชนิดของวัตถุ เขตข้อมูลนี้ถูกตั้งค่าเป็น content#productsListResponse	สตริง	<ชนิด>
nextPageToken	รับโทเค็นที่ใช้ในการรับหน้าผลลัพธ์ถัดไป ถ้าวัตถุไม่รวมเขตข้อมูลนี้ จะไม่มีหน้าที่จะรับอีก ดูโทเค็นเริ่มต้น	สตริง	<next_page_token>
ทรัพยากร	รับรายการผลิตภัณฑ์ หากแค็ตตาล็อกไม่มีข้อเสนอใด ๆ อาร์เรย์จะว่างเปล่า	ผลิตภัณฑ์[]	<ผลิตภัณฑ์>

ProductShipping

กําหนดต้นทุนการจัดส่ง

ชื่อ	ค่า	ชนิด	ชื่อองค์ประกอบ XML
ประเทศ	รับหรือตั้งค่ารหัสประเทศ ISO 3166 สองตัวอักษรของประเทศที่จัดส่งสินค้าไป	สตริง	<ประเทศ>
locationGroupName	รับหรือตั้งชื่อกลุ่มตําแหน่งที่ตั้ง	สตริง	<location_group_name>
locationId	รับหรือตั้งค่ารหัสของตําแหน่งที่ตั้งทางภูมิศาสตร์ที่มีการจัดส่งสินค้าไป สําหรับรายการรหัส ให้ดู รหัสที่ตั้งทางภูมิศาสตร์	สตริง	<location_id>
รหัสไปรษณีย์	รับหรือตั้งค่ารหัสไปรษณีย์หรือช่วงรหัสไปรษณีย์ของที่ตั้งที่มีการจัดส่งสินค้าไปให้ คุณสามารถระบุรหัสไปรษณีย์ได้ดังนี้: รหัสไปรษณีย์ที่สมบูรณ์: 94114 รหัสไปรษณีย์ที่มีสัญลักษณ์ตัวแทน (เฉพาะคําต่อท้าย): 94* ช่วงของรหัส: 94002-95460 ช่วงของรหัสที่มีอักขระตัวแทน (คํานําหน้ารหัสไปรษณีย์ต้องมีความยาวเท่ากัน: 94*-95*	สตริง	<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>
รหัสไปรษณีย์	รับหรือตั้งค่ารหัสไปรษณีย์หรือช่วงของรหัสไปรษณีย์ที่ใช้อัตราภาษี คุณสามารถระบุรหัสไปรษณีย์ได้ดังนี้: รหัสไปรษณีย์ที่สมบูรณ์: 94114 รหัสไปรษณีย์ที่มีสัญลักษณ์ตัวแทน (เฉพาะคําต่อท้าย): 94* ช่วงของรหัส: 94002-95460 ช่วงของรหัสที่มีอักขระตัวแทน (คํานําหน้ารหัสไปรษณีย์ต้องมีความยาวเท่ากัน: 94*-95*	สตริง	<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	ข้อผิดพลาดที่เซิร์ฟเวอร์