หน้านี้ได้รับการแปลโดย Cloud Translation API

Package google.shopping.merchant.products.v1beta

ดัชนี

ProductInputsService (อินเทอร์เฟซ)
ProductsService (อินเทอร์เฟซ)
Attributes (ข้อความ)
Certification (ข้อความ)
CloudExportAdditionalProperties (ข้อความ)
DeleteProductInputRequest (ข้อความ)
FreeShippingThreshold (ข้อความ)
GetProductRequest (ข้อความ)
InsertProductInputRequest (ข้อความ)
Installment (ข้อความ)
ListProductsRequest (ข้อความ)
ListProductsResponse (ข้อความ)
LoyaltyPoints (ข้อความ)
LoyaltyProgram (ข้อความ)
Product (ข้อความ)
ProductDetail (ข้อความ)
ProductDimension (ข้อความ)
ProductInput (ข้อความ)
ProductStatus (ข้อความ)
ProductStatus.DestinationStatus (ข้อความ)
ProductStatus.ItemLevelIssue (ข้อความ)
ProductStatus.ItemLevelIssue.Severity (enum)
ProductStructuredDescription (ข้อความ)
ProductStructuredTitle (ข้อความ)
ProductSustainabilityIncentive (ข้อความ)
ProductSustainabilityIncentive.Type (enum)
ProductWeight (ข้อความ)
Shipping (ข้อความ)
ShippingDimension (ข้อความ)
ShippingWeight (ข้อความ)
SubscriptionCost (ข้อความ)
SubscriptionPeriod (enum)
Tax (ข้อความ)
UnitPricingBaseMeasure (ข้อความ)
UnitPricingMeasure (ข้อความ)

ProductInputsService

บริการที่จะใช้ทรัพยากร ProductInput บริการนี้ใช้ได้กับผลิตภัณฑ์ที่มีช่องทางออนไลน์เท่านั้น

DeleteProductInput

DeleteProductInput
`rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)` ลบข้อมูลผลิตภัณฑ์ที่ป้อนออกจากบัญชี Merchant Center หลังจากแทรก อัปเดต หรือลบข้อมูลผลิตภัณฑ์แล้ว ระบบอาจใช้เวลา 2-3 นาทีจึงจะเรียกข้อมูลผลิตภัณฑ์ที่ประมวลผลแล้วได้ ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ `https://www.googleapis.com/auth/content` ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

ลบข้อมูลผลิตภัณฑ์ที่ป้อนออกจากบัญชี Merchant Center

หลังจากแทรก อัปเดต หรือลบข้อมูลผลิตภัณฑ์แล้ว ระบบอาจใช้เวลา 2-3 นาทีจึงจะเรียกข้อมูลผลิตภัณฑ์ที่ประมวลผลแล้วได้

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

https://www.googleapis.com/auth/content

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

InsertProductInput

InsertProductInput
`rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)` อัปโหลดอินพุตผลิตภัณฑ์ไปยังบัญชี Merchant Center หากมีอินพุตที่มี contentLanguage, offerId และ dataSource เดียวกันอยู่แล้ว วิธีการนี้จะแทนที่รายการนั้น หลังจากแทรก อัปเดต หรือลบอินพุตผลิตภัณฑ์แล้ว ระบบอาจใช้เวลา 2-3 นาทีก่อนที่จะเรียกข้อมูลผลิตภัณฑ์ที่ประมวลผลแล้วได้ ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ `https://www.googleapis.com/auth/content` ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

อัปโหลดอินพุตผลิตภัณฑ์ไปยังบัญชี Merchant Center หากมีอินพุตที่มี contentLanguage, offerId และ dataSource เดียวกันอยู่แล้ว วิธีการนี้จะแทนที่รายการนั้น

หลังจากแทรก อัปเดต หรือลบอินพุตผลิตภัณฑ์แล้ว ระบบอาจใช้เวลา 2-3 นาทีก่อนที่จะเรียกข้อมูลผลิตภัณฑ์ที่ประมวลผลแล้วได้

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

https://www.googleapis.com/auth/content

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

ProductsService

บริการเพื่อใช้ทรัพยากรผลิตภัณฑ์ บริการนี้ใช้ได้กับผลิตภัณฑ์ที่มีช่องทางออนไลน์เท่านั้น

GetProduct

GetProduct
`rpc GetProduct(GetProductRequest) returns (Product)` ดึงข้อมูลผลิตภัณฑ์ที่ประมวลผลแล้วจากบัญชี Merchant Center หลังจากแทรก อัปเดต หรือลบข้อมูลผลิตภัณฑ์แล้ว ระบบอาจใช้เวลา 2-3 นาทีก่อนที่จะดึงข้อมูลผลิตภัณฑ์ขั้นสุดท้ายที่อัปเดตแล้วได้ ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ `https://www.googleapis.com/auth/content` ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

rpc GetProduct(GetProductRequest) returns (Product)

ดึงข้อมูลผลิตภัณฑ์ที่ประมวลผลแล้วจากบัญชี Merchant Center

หลังจากแทรก อัปเดต หรือลบข้อมูลผลิตภัณฑ์แล้ว ระบบอาจใช้เวลา 2-3 นาทีก่อนที่จะดึงข้อมูลผลิตภัณฑ์ขั้นสุดท้ายที่อัปเดตแล้วได้

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

https://www.googleapis.com/auth/content

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

ListProducts

ListProducts
`rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)` แสดงผลิตภัณฑ์ที่ประมวลผลแล้วในบัญชี Merchant Center การตอบกลับอาจมีรายการน้อยกว่าที่ระบุโดย pageSize ใช้ pageToken เพื่อระบุว่ามีรายการอื่นๆ ที่จะขอหรือไม่ หลังจากแทรก อัปเดต หรือลบข้อมูลผลิตภัณฑ์แล้ว ระบบอาจใช้เวลา 2-3 นาทีจึงจะเรียกดูผลิตภัณฑ์ที่ประมวลผลแล้วซึ่งอัปเดตแล้วได้ ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ `https://www.googleapis.com/auth/content` ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

แสดงผลิตภัณฑ์ที่ประมวลผลแล้วในบัญชี Merchant Center การตอบกลับอาจมีรายการน้อยกว่าที่ระบุโดย pageSize ใช้ pageToken เพื่อระบุว่ามีรายการอื่นๆ ที่จะขอหรือไม่

หลังจากแทรก อัปเดต หรือลบข้อมูลผลิตภัณฑ์แล้ว ระบบอาจใช้เวลา 2-3 นาทีจึงจะเรียกดูผลิตภัณฑ์ที่ประมวลผลแล้วซึ่งอัปเดตแล้วได้

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

https://www.googleapis.com/auth/content

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

Attributes

แอตทริบิวต์

ช่อง
`additional_image_links[]`	`string` URL เพิ่มเติมของรูปภาพสินค้า
`expiration_date`	`Timestamp` วันที่ที่รายการควรหมดอายุตามที่ระบุไว้เมื่อแทรกในรูปแบบ ISO 8601 วันที่หมดอายุจริงจะแสดงใน `productstatuses` เป็น googleExpirationDate และอาจเร็วกว่านั้นหาก `expirationDate` อยู่ไกลจากปัจจุบันเกินไป
`disclosure_date`	`Timestamp` วันที่และเวลาที่ข้อเสนอจะปรากฏในผลการค้นหาบนแพลตฟอร์มต่างๆ ใน YouTube ของ Google ในรูปแบบ ISO 8601 ดูข้อมูลเพิ่มเติมได้ที่ [วันที่เปิดตัว]( https://support.google.com/merchants/answer/13034208)
`availability_date`	`Timestamp` วันที่พร้อมจัดส่งผลิตภัณฑ์ที่สั่งจองล่วงหน้าในรูปแบบ ISO 8601
`gtin[]`	`string` หมายเลขสินค้าการค้าสากล (GTIN) ของสินค้า คุณระบุ GTIN ได้สูงสุด 10 รายการ
`price`	`Price` ราคาของสินค้า
`installment`	`Installment` จำนวนและจำนวนเงินผ่อนชำระสำหรับสินค้า
`subscription_cost`	`SubscriptionCost` จำนวนระยะเวลา (เดือนหรือปี) และจำนวนเงินที่ชำระต่อระยะเวลาสำหรับรายการที่มีสัญญาการสมัครใช้บริการที่เกี่ยวข้อง
`loyalty_points`	`LoyaltyPoints` คะแนนสะสมที่ผู้ใช้ได้รับหลังจากซื้อไอเทม ญี่ปุ่นเท่านั้น
`loyalty_programs[]`	`LoyaltyProgram` รายการข้อมูลโปรแกรมสะสมคะแนนที่ใช้แสดงสิทธิประโยชน์จากการสะสมคะแนน (เช่น ราคาที่ดีกว่า คะแนน ฯลฯ) ต่อผู้ใช้สินค้านี้
`product_types[]`	`string` หมวดหมู่ของสินค้า (มีรูปแบบตามข้อกำหนดในการจัดทำข้อมูลผลิตภัณฑ์)
`sale_price`	`Price` ราคาลดที่โฆษณาของสินค้า
`sale_price_effective_date`	`Interval` ช่วงวันที่ที่สินค้าลดราคาอยู่ (ดูข้อกำหนดในการจัดทำข้อมูลผลิตภัณฑ์)
`product_height`	`ProductDimension` ความสูงของผลิตภัณฑ์ในหน่วยที่ระบุ ค่าต้องอยู่ระหว่าง 0 (ไม่รวม) ถึง 3000 (รวม)
`product_length`	`ProductDimension` ความยาวของผลิตภัณฑ์ในหน่วยที่ระบุ ค่าต้องอยู่ระหว่าง 0 (ไม่รวม) ถึง 3000 (รวม)
`product_width`	`ProductDimension` ความกว้างของผลิตภัณฑ์ในหน่วยที่ระบุ ค่าต้องอยู่ระหว่าง 0 (ไม่รวม) ถึง 3000 (รวม)
`product_weight`	`ProductWeight` น้ำหนักของผลิตภัณฑ์ในหน่วยที่ระบุ ค่าต้องอยู่ระหว่าง 0 (ไม่รวม) ถึง 2000 (รวม)
`shipping[]`	`Shipping` กฎการจัดส่ง
`free_shipping_threshold[]`	`FreeShippingThreshold` เงื่อนไขที่ผลิตภัณฑ์ต้องมีคุณสมบัติตรงตามจึงจะมีสิทธิ์จัดส่งฟรี
`shipping_weight`	`ShippingWeight` น้ำหนักของสินค้าสำหรับการจัดส่ง
`shipping_length`	`ShippingDimension` ความยาวของสินค้าสำหรับการจัดส่ง
`shipping_width`	`ShippingDimension` ความกว้างของสินค้าสำหรับการจัดส่ง
`shipping_height`	`ShippingDimension` ความสูงของสินค้าสำหรับการจัดส่ง
`size_types[]`	`string` การตัดของสินค้า ซึ่งสามารถใช้เพื่อแสดงประเภทขนาดแบบรวมสำหรับสินค้าเครื่องแต่งกาย ระบุประเภทขนาดได้สูงสุด 2 ประเภท (ดู [https://support.google.com/merchants/answer/6324497](ประเภทขนาด))
`taxes[]`	`Tax` ข้อมูลภาษี
`unit_pricing_measure`	`UnitPricingMeasure` หน่วยวัดและขนาดของสินค้า
`unit_pricing_base_measure`	`UnitPricingBaseMeasure` ค่ากำหนดของตัวส่วนราคาต่อหน่วย
`ads_labels[]`	`string` คล้ายกับ ads_grouping แต่ใช้ได้กับ CPC เท่านั้น
`cost_of_goods_sold`	`Price` ต้นทุนสินค้าขาย ใช้สำหรับการรายงานกําไรขั้นต้น
`product_details[]`	`ProductDetail` ข้อกำหนดทางเทคนิคหรือรายละเอียดเพิ่มเติมของผลิตภัณฑ์
`product_highlights[]`	`string` หัวข้อย่อยที่อธิบายไฮไลต์ที่เกี่ยวข้องที่สุดของผลิตภัณฑ์
`display_ads_similar_ids[]`	`string` คำแนะนำที่ผู้ลงโฆษณาระบุ
`promotion_ids[]`	`string` รหัสที่ไม่ซ้ำกันของโปรโมชัน
`included_destinations[]`	`string` รายการปลายทางที่จะรวมสำหรับเป้าหมายนี้ (ตรงกับช่องทำเครื่องหมายที่เลือกไว้ใน Merchant Center) ระบบจะรวมปลายทางเริ่มต้นเสมอ เว้นแต่จะมีการระบุไว้ใน `excludedDestinations`
`excluded_destinations[]`	`string` รายการปลายทางที่จะยกเว้นสําหรับเป้าหมายนี้ (ตรงกับช่องทําเครื่องหมายที่ยังไม่ได้เลือกใน Merchant Center)
`shopping_ads_excluded_countries[]`	`string` รายการรหัสประเทศ (ISO 3166-1 alpha-2) เพื่อยกเว้นข้อเสนอจากปลายทางโฆษณา Shopping ระบบจะนำประเทศในรายการนี้ออกจากประเทศที่กำหนดค่าไว้ในการตั้งค่าแหล่งข้อมูล
`lifestyle_image_links[]`	`string` URL เพิ่มเติมของรูปภาพไลฟ์สไตล์ของสินค้า ซึ่งใช้ระบุรูปภาพที่แสดงสินค้าในบริบทของชีวิตจริงอย่างชัดเจน ดูข้อมูลเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือ
`cloud_export_additional_properties[]`	`CloudExportAdditionalProperties` ฟิลด์เพิ่มเติมที่จะส่งออกไปยังโปรแกรม Cloud Retail
`certifications[]`	`Certification` การรับรองผลิตภัณฑ์ เช่น การรับรองฉลากประสิทธิภาพการประหยัดพลังงานของผลิตภัณฑ์ที่บันทึกไว้ในฐานข้อมูล EPREL ของสหภาพยุโรป ดูข้อมูลเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือ
`auto_pricing_min_price`	`Price` มาตรการป้องกันในโปรเจ็กต์ "ส่วนลดอัตโนมัติ" (https://support.google.com/merchants/answer/10295759) และ "โปรโมชันแบบไดนามิก" (https://support.google.com/merchants/answer/13949249) ซึ่งช่วยให้มั่นใจว่าส่วนลดสำหรับข้อเสนอของผู้ขายจะไม่ต่ำกว่ามูลค่านี้ จึงช่วยรักษามูลค่าและความสามารถในการทำกำไรของข้อเสนอ
`sustainability_incentives[]`	`ProductSustainabilityIncentive` รายการโปรแกรมจูงใจด้านความยั่งยืน
`identifier_exists`	`bool` ตั้งค่านี้เป็น "เท็จ" เมื่อสินค้าไม่มีรหัสระบุผลิตภัณฑ์ที่เหมาะสมกับหมวดหมู่ เช่น GTIN, MPN และแบรนด์ ค่าเริ่มต้นจะเป็น "จริง" หากไม่ได้ระบุไว้
`is_bundle`	`bool` สินค้าเป็นแพ็กเกจที่ผู้ขายกำหนดหรือไม่ แพ็กเกจคือการจัดกลุ่มผลิตภัณฑ์ต่างๆ ที่ผู้ขายกำหนดเองเพื่อขายในราคาเดียว
`title`	`string` ชื่อของสินค้า
`description`	`string` คําอธิบายของสินค้า
`link`	`string` URL ที่ลิงก์ไปยังหน้าของสินค้าในร้านค้าออนไลน์โดยตรง
`mobile_link`	`string` URL สำหรับหน้า Landing Page ของสินค้าเวอร์ชันที่เพิ่มประสิทธิภาพสำหรับอุปกรณ์เคลื่อนที่
`canonical_link`	`string` URL สำหรับหน้า Landing Page ของสินค้าเวอร์ชัน Canonical
`image_link`	`string` URL รูปภาพของสินค้า
`adult`	`bool` ตั้งค่าเป็น "จริง" หากสินค้ามีไว้สำหรับผู้ใหญ่
`age_group`	`string` กลุ่มอายุเป้าหมายของสินค้า
`availability`	`string` สถานะความพร้อมจำหน่ายของสินค้า
`brand`	`string` แบรนด์ของสินค้า
`color`	`string` สีของสินค้า
`condition`	`string` สภาพสินค้าหรือสถานะของสินค้า
`gender`	`string` เพศเป้าหมายของสินค้า
`google_product_category`	`string` หมวดหมู่สินค้าของ Google (ดูการจัดหมวดหมู่ผลิตภัณฑ์ของ Google) เมื่อค้นหาผลิตภัณฑ์ ฟิลด์นี้จะมีค่าที่ผู้ใช้ระบุ ขณะนี้ยังไม่มีวิธีรับหมวดหมู่ผลิตภัณฑ์ Google ที่กำหนดโดยอัตโนมัติกลับคืนผ่าน API
`item_group_id`	`string` ตัวระบุที่ใช้ร่วมกันสำหรับผลิตภัณฑ์ย่อยทั้งหมดของผลิตภัณฑ์เดียวกัน
`material`	`string` วัสดุที่ใช้ผลิตสินค้า
`mpn`	`string` หมายเลขชิ้นส่วนของผู้ผลิต (MPN) สำหรับสินค้า
`pattern`	`string` ลวดลายของสินค้า (เช่น ลายจุด)
`sell_on_google_quantity`	`int64` จำนวนผลิตภัณฑ์ที่พร้อมจำหน่ายบน Google รองรับเฉพาะผลิตภัณฑ์ออนไลน์เท่านั้น
`max_handling_time`	`int64` วันทำการสูงสุดก่อนจัดส่งผลิตภัณฑ์ (เป็นวันทำการ)
`min_handling_time`	`int64` วันทำการก่อนจัดส่งขั้นต่ำของผลิตภัณฑ์ (วันทำการ)
`shipping_label`	`string` ป้ายกำกับการจัดส่งของผลิตภัณฑ์ ซึ่งใช้เพื่อจัดกลุ่มผลิตภัณฑ์ในกฎการจัดส่งระดับบัญชี
`transit_time_label`	`string` ป้ายกำกับเวลาขนส่งของผลิตภัณฑ์ ซึ่งใช้เพื่อจัดกลุ่มผลิตภัณฑ์ในตารางเวลาขนส่งระดับบัญชี
`size`	`string` ขนาดของสินค้า อนุญาตเพียงค่าเดียว สำหรับผลิตภัณฑ์ย่อยที่มีขนาดแตกต่างกัน ให้แทรกผลิตภัณฑ์แยกต่างหากสำหรับแต่ละขนาดที่มีค่า `itemGroupId` เดียวกัน (ดู [https://support.google.com/merchants/answer/6324492](คำจำกัดความของขนาด))
`size_system`	`string` ระบบที่ระบุขนาด แนะนำสำหรับสินค้าประเภทเครื่องแต่งกาย
`tax_category`	`string` หมวดหมู่ภาษีของผลิตภัณฑ์
`energy_efficiency_class`	`string` ระดับการประหยัดพลังงานตามที่ระบุไว้ในคำสั่งของสหภาพยุโรป 2010/30/EU
`min_energy_efficiency_class`	`string` ระดับการประหยัดพลังงานตามที่ระบุไว้ในคำสั่งของสหภาพยุโรป 2010/30/EU
`max_energy_efficiency_class`	`string` ระดับการประหยัดพลังงานตามที่ระบุไว้ในคำสั่ง 2010/30/EU ของสหภาพยุโรป
`multipack`	`int64` จำนวนผลิตภัณฑ์ที่เหมือนกันในแพ็กใหญ่ตามที่ผู้ขายกำหนด
`ads_grouping`	`string` ใช้เพื่อจัดกลุ่มสินค้าตามวิธีที่กำหนดเอง สำหรับ CPA% เท่านั้น ไม่แนะนําให้ใช้ในกรณีอื่น
`ads_redirect`	`string` อนุญาตให้ผู้ลงโฆษณาลบล้าง URL ของสินค้าเมื่อผลิตภัณฑ์แสดงในบริบทของโฆษณาผลิตภัณฑ์
`display_ads_id`	`string` ตัวระบุสินค้าสำหรับแคมเปญรีมาร์เก็ตติ้งแบบไดนามิก
`display_ads_title`	`string` ชื่อสินค้าสําหรับแคมเปญรีมาร์เก็ตติ้งแบบไดนามิก
`display_ads_link`	`string` URL ไปยังหน้า Landing Page ของสินค้าสำหรับแคมเปญรีมาร์เก็ตติ้งแบบไดนามิกโดยตรง
`display_ads_value`	`double` อัตรากําไรของข้อเสนอสําหรับแคมเปญรีมาร์เก็ตติ้งแบบไดนามิก
`pickup_method`	`string` ตัวเลือกการรับสินค้า
`pickup_sla`	`string` ลำดับเวลาการรับสินค้าที่ร้านค้า
`link_template`	`string` เทมเพลตลิงก์สำหรับหน้าร้านในพื้นที่ที่ผู้ขายโฮสต์
`mobile_link_template`	`string` เทมเพลตลิงก์สำหรับหน้าร้านในพื้นที่ที่ผู้ขายโฮสต์ซึ่งมีการเพิ่มประสิทธิภาพสำหรับอุปกรณ์เคลื่อนที่
`custom_label_0`	`string` ป้ายกํากับที่กําหนดเอง 0 สําหรับการจัดกลุ่มรายการในแคมเปญ Shopping
`custom_label_1`	`string` ป้ายกํากับที่กําหนดเอง 1 สําหรับการจัดกลุ่มรายการในแคมเปญ Shopping
`custom_label_2`	`string` ป้ายกํากับที่กําหนดเอง 2 สําหรับการจัดกลุ่มรายการในแคมเปญ Shopping
`custom_label_3`	`string` ป้ายกํากับที่กําหนดเอง 3 สําหรับการจัดกลุ่มรายการในแคมเปญ Shopping
`custom_label_4`	`string` ป้ายกํากับที่กําหนดเอง 4 สําหรับการจัดกลุ่มรายการในแคมเปญ Shopping
`external_seller_id`	`string` ต้องระบุสำหรับบัญชีผู้ขายหลายราย ใช้แอตทริบิวต์นี้ในกรณีที่คุณเป็นผู้ให้บริการมาร์เก็ตเพลสที่อัปโหลดผลิตภัณฑ์สำหรับผู้ขายหลายรายไปยังบัญชีผู้ขายหลายราย
`pause`	`string` ระบบจะหยุดการเผยแพร่รายการนี้ไว้ชั่วคราว
`virtual_model_link`	`string` URL ของรูปภาพ 3 มิติของสินค้า ดูข้อมูลเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือ
`structured_title`	`ProductStructuredTitle` ชื่อที่มีโครงสร้างสำหรับชื่อที่สร้างขึ้นโดยอัลกอริทึม (AI)
`structured_description`	`ProductStructuredDescription` รายละเอียดที่มีโครงสร้างสำหรับคำอธิบายที่สร้างขึ้นโดยอัลกอริทึม (AI)

การรับรอง

การรับรองผลิตภัณฑ์ ซึ่งเปิดตัวครั้งแรกเพื่อปฏิบัติตามข้อกำหนดการติดฉลากการประหยัดพลังงานของสหภาพยุโรปโดยใช้ฐานข้อมูล EPREL ของสหภาพยุโรป

ช่อง
`certification_authority`	`string` หน่วยงานที่รับรอง เช่น "European_Commission" ความยาวสูงสุด 2,000 อักขระ
`certification_name`	`string` ชื่อของใบรับรอง เช่น "EPREL" ความยาวสูงสุด 2,000 อักขระ
`certification_code`	`string` รหัสการรับรอง ความยาวสูงสุด 2,000 อักขระ
`certification_value`	`string` ค่าการรับรอง (หรือที่เรียกว่าระดับชั้น ระดับ หรือคะแนน) เช่น "A+", "C", "gold" ความยาวสูงสุด 2,000 อักขระ

CloudExportAdditionalProperties

พร็อพเพอร์ตี้ผลิตภัณฑ์สำหรับ Cloud Retail API เช่น พร็อพเพอร์ตี้สำหรับผลิตภัณฑ์ทีวีอาจเป็น "Screen-Resolution" หรือ "Screen-Size"

ช่อง
`text_value[]`	`string` ค่าข้อความของพร็อพเพอร์ตี้ที่ระบุ เช่น "8K(UHD)" อาจเป็นค่าข้อความสำหรับผลิตภัณฑ์ทีวี จำนวนครั้งที่ซ้ำสูงสุดของค่านี้คือ 400 ระบบจะจัดเก็บค่าตามลําดับที่กําหนดเองแต่สอดคล้องกัน ขนาดสตริงสูงสุดคือ 256 อักขระ
`int_value[]`	`int64` ค่าจำนวนเต็มของพร็อพเพอร์ตี้หนึ่งๆ เช่น 1080 สำหรับความละเอียดหน้าจอของผลิตภัณฑ์ทีวี จำนวนครั้งที่ซ้ำสูงสุดของค่านี้คือ 400 ระบบจะจัดเก็บค่าตามลําดับที่กําหนดเองแต่สอดคล้องกัน
`float_value[]`	`float` ค่าลอยตัวของพร็อพเพอร์ตี้หนึ่งๆ เช่น 1.2345 สำหรับผลิตภัณฑ์ทีวี จำนวนครั้งที่ซ้ำสูงสุดของค่านี้คือ 400 ระบบจะจัดเก็บค่าตามลําดับที่กําหนดเองแต่สอดคล้องกัน
`property_name`	`string` ชื่อของพร็อพเพอร์ตี้ที่ระบุ เช่น "Screen-Resolution" สำหรับผลิตภัณฑ์ทีวี ขนาดสตริงสูงสุดคือ 256 อักขระ
`bool_value`	`bool` ค่าบูลีนของพร็อพเพอร์ตี้ที่ระบุ เช่น สำหรับผลิตภัณฑ์ทีวี ให้ใช้ "จริง" หรือ "เท็จ" หากหน้าจอเป็น UHD
`min_value`	`float` ค่าลอยขั้นต่ำของพร็อพเพอร์ตี้ที่ระบุ เช่น 1.00 สำหรับผลิตภัณฑ์ทีวี
`max_value`	`float` ค่าลอยตัวสูงสุดของพร็อพเพอร์ตี้ที่ระบุ เช่น 100.00 สำหรับผลิตภัณฑ์ทีวี
`unit_code`	`string` หน่วยของที่พักที่ระบุ เช่น "พิกเซล" สำหรับผลิตภัณฑ์ทีวี ขนาดสตริงสูงสุดคือ 256B

DeleteProductInputRequest

ข้อความคําขอสําหรับเมธอด DeleteProductInput

ช่อง

ช่อง
`name`	`string` ต้องระบุ ชื่อของแหล่งข้อมูลอินพุตผลิตภัณฑ์ที่จะลบ รูปแบบ: accounts/{account}/productInputs/{product} โดยส่วนที่ `product` สุดท้ายประกอบด้วย 4 ส่วน ได้แก่ channel~content_language~feed_label~offer_id ตัวอย่างชื่อผลิตภัณฑ์คือ "accounts/123/productInputs/online~en~US~sku123"
`data_source`	`string` ต้องระบุ แหล่งข้อมูลหลักหรือแหล่งข้อมูลเสริมที่ควรลบข้อมูลผลิตภัณฑ์ออก รูปแบบ: `accounts/{account}/dataSources/{datasource}`

name

string

ต้องระบุ ชื่อของแหล่งข้อมูลอินพุตผลิตภัณฑ์ที่จะลบ รูปแบบ: accounts/{account}/productInputs/{product} โดยส่วนที่ product สุดท้ายประกอบด้วย 4 ส่วน ได้แก่ channel~content_language~feed_label~offer_id ตัวอย่างชื่อผลิตภัณฑ์คือ "accounts/123/productInputs/online~en~US~sku123"

data_source

string

ต้องระบุ แหล่งข้อมูลหลักหรือแหล่งข้อมูลเสริมที่ควรลบข้อมูลผลิตภัณฑ์ออก รูปแบบ: accounts/{account}/dataSources/{datasource}

FreeShippingThreshold

เงื่อนไขที่ผลิตภัณฑ์ต้องมีคุณสมบัติตรงตามจึงจะมีสิทธิ์จัดส่งฟรี

ช่อง

ช่อง
`country`	`string` รหัสเขตแดน CLDR ของประเทศที่จะจัดส่งสินค้า
`price_threshold`	`Price` ราคาผลิตภัณฑ์ขั้นต่ำที่จะมีบริการจัดส่งฟรี แสดงเป็นตัวเลข

country

string

รหัสเขตแดน CLDR ของประเทศที่จะจัดส่งสินค้า

price_threshold

Price

ราคาผลิตภัณฑ์ขั้นต่ำที่จะมีบริการจัดส่งฟรี แสดงเป็นตัวเลข

GetProductRequest

ข้อความคําขอสําหรับเมธอด GetProduct

ช่อง

ช่อง
`name`	`string` ต้องระบุ ชื่อผลิตภัณฑ์ที่จะดึงข้อมูล รูปแบบ: `accounts/{account}/products/{product}` โดยส่วนที่ `product` สุดท้ายประกอบด้วย 4 ส่วน ได้แก่ channel~content_language~feed_label~offer_id ตัวอย่างชื่อผลิตภัณฑ์คือ "accounts/123/products/online~en~US~sku123"

name

string

ต้องระบุ ชื่อผลิตภัณฑ์ที่จะดึงข้อมูล รูปแบบ: accounts/{account}/products/{product} โดยส่วนที่ product สุดท้ายประกอบด้วย 4 ส่วน ได้แก่ channel~content_language~feed_label~offer_id ตัวอย่างชื่อผลิตภัณฑ์คือ "accounts/123/products/online~en~US~sku123"

InsertProductInputRequest

ข้อความคําขอสําหรับเมธอด InsertProductInput

ช่อง

ช่อง
`parent`	`string` ต้องระบุ บัญชีที่จะแทรกผลิตภัณฑ์นี้ รูปแบบ: accounts/{account}
`product_input`	`ProductInput` ต้องระบุ อินพุตผลิตภัณฑ์ที่จะแทรก
`data_source`	`string` ต้องระบุ ชื่อแหล่งข้อมูลผลิตภัณฑ์หลักหรือแหล่งข้อมูลเสริม หากผลิตภัณฑ์มีอยู่แล้วและแหล่งข้อมูลที่ระบุไว้แตกต่างกัน ระบบจะย้ายผลิตภัณฑ์ไปยังแหล่งข้อมูลใหม่ รองรับเฉพาะแหล่งข้อมูล API เท่านั้น รูปแบบ: `accounts/{account}/dataSources/{datasource}`

parent

string

ต้องระบุ บัญชีที่จะแทรกผลิตภัณฑ์นี้ รูปแบบ: accounts/{account}

product_input

ProductInput

ต้องระบุ อินพุตผลิตภัณฑ์ที่จะแทรก

data_source

string

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

รองรับเฉพาะแหล่งข้อมูล API เท่านั้น

รูปแบบ: accounts/{account}/dataSources/{datasource}

การผ่อนชำระ

ข้อความที่แสดงการผ่อนชำระ

ช่อง
`months`	`int64` จำนวนงวดการผ่อนชำระที่ผู้ซื้อต้องชำระ
`amount`	`Price` จำนวนเงินที่ผู้ซื้อต้องชำระต่อเดือน
`downpayment`	`Price` จำนวนเงินดาวน์ที่ผู้ซื้อต้องชำระล่วงหน้า
`credit_type`	`string` ประเภทการชําระเงินผ่อน ค่าที่รองรับมีดังนี้ * "`finance`" * "`lease`"

ListProductsRequest

ข้อความคําขอสําหรับเมธอด ListProducts

ช่อง

ช่อง
`parent`	`string` ต้องระบุ บัญชีที่จะแสดงผลิตภัณฑ์ที่ประมวลผลแล้ว รูปแบบ: accounts/{account}
`page_size`	`int32` จำนวนผลิตภัณฑ์สูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ ค่าสูงสุดคือ 250 ค่าที่มากกว่า 250 จะเปลี่ยนเป็น 250 หากไม่ระบุ ระบบจะแสดงผลผลิตภัณฑ์สูงสุด
`page_token`	`string` โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ `ListProducts` ก่อนหน้านี้ ระบุข้อมูลนี้เพื่อเรียกข้อมูลหน้าถัดไป เมื่อแบ่งหน้าเว็บ พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ `ListProducts` ต้องตรงกับการเรียกที่ให้โทเค็นหน้าเว็บ

parent

string

ต้องระบุ บัญชีที่จะแสดงผลิตภัณฑ์ที่ประมวลผลแล้ว รูปแบบ: accounts/{account}

page_size

int32

จำนวนผลิตภัณฑ์สูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ ค่าสูงสุดคือ 250 ค่าที่มากกว่า 250 จะเปลี่ยนเป็น 250 หากไม่ระบุ ระบบจะแสดงผลผลิตภัณฑ์สูงสุด

page_token

string

โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ ListProducts ก่อนหน้านี้ ระบุข้อมูลนี้เพื่อเรียกข้อมูลหน้าถัดไป

เมื่อแบ่งหน้าเว็บ พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ ListProducts ต้องตรงกับการเรียกที่ให้โทเค็นหน้าเว็บ

ListProductsResponse

ข้อความตอบกลับสําหรับเมธอด ListProducts

ช่อง

ช่อง
`products[]`	`Product` ผลิตภัณฑ์ที่ประมวลผลแล้วจากบัญชีที่ระบุ ผลิตภัณฑ์เหล่านี้คือผลิตภัณฑ์ที่ประมวลผลแล้วหลังจากใช้กฎและแหล่งข้อมูลเสริม
`next_page_token`	`string` โทเค็น ซึ่งสามารถส่งเป็น `page_token` เพื่อเรียกข้อมูลหน้าถัดไป หากละเว้นช่องนี้ จะไม่มีหน้าถัดไป

products[]

Product

ผลิตภัณฑ์ที่ประมวลผลแล้วจากบัญชีที่ระบุ ผลิตภัณฑ์เหล่านี้คือผลิตภัณฑ์ที่ประมวลผลแล้วหลังจากใช้กฎและแหล่งข้อมูลเสริม

next_page_token

string

โทเค็น ซึ่งสามารถส่งเป็น page_token เพื่อเรียกข้อมูลหน้าถัดไป หากละเว้นช่องนี้ จะไม่มีหน้าถัดไป

LoyaltyPoints

ข้อความที่เป็นตัวแทนคะแนนสะสม

ช่อง

ช่อง
`name`	`string` ชื่อโปรแกรมคะแนนสะสม เราขอแนะนำให้จำกัดชื่อให้มีอักขระแบบเต็มความกว้างไม่เกิน 12 ตัวหรืออักขระโรมันไม่เกิน 24 ตัว
`points_value`	`int64` คะแนนสะสมของผู้ค้าปลีกในรูปแบบค่าสัมบูรณ์
`ratio`	`double` อัตราส่วนของคะแนนเมื่อแปลงเป็นสกุลเงิน Google จะถือว่าสกุลเงินดังกล่าวอิงตามการตั้งค่า Merchant Center หากไม่ระบุอัตราส่วน ระบบจะใช้ค่าเริ่มต้นเป็น 1.0

name

string

ชื่อโปรแกรมคะแนนสะสม เราขอแนะนำให้จำกัดชื่อให้มีอักขระแบบเต็มความกว้างไม่เกิน 12 ตัวหรืออักขระโรมันไม่เกิน 24 ตัว

points_value

int64

คะแนนสะสมของผู้ค้าปลีกในรูปแบบค่าสัมบูรณ์

ratio

double

อัตราส่วนของคะแนนเมื่อแปลงเป็นสกุลเงิน Google จะถือว่าสกุลเงินดังกล่าวอิงตามการตั้งค่า Merchant Center หากไม่ระบุอัตราส่วน ระบบจะใช้ค่าเริ่มต้นเป็น 1.0

LoyaltyProgram

ข้อความที่แสดงถึงโปรแกรมสะสมคะแนน

ช่อง
`program_label`	`string` ป้ายกำกับโปรแกรมสะสมคะแนน นี่เป็นป้ายกำกับภายในที่ระบุความสัมพันธ์ระหว่างเอนทิตีผู้ขายกับเอนทิตีโปรแกรมสะสมคะแนนอย่างเจาะจง คุณต้องระบุป้ายกำกับเพื่อให้ระบบเชื่อมโยงชิ้นงานด้านล่าง (เช่น ราคาและคะแนน) กับผู้ขายได้ โปรแกรมที่เกี่ยวข้องต้องลิงก์กับบัญชีผู้ขาย
`tier_label`	`string` ป้ายกำกับของระดับภายในโปรแกรมสะสมคะแนน ต้องตรงกับป้ายกำกับใดป้ายกำกับหนึ่งภายในโปรแกรม
`price`	`Price` ราคาสำหรับสมาชิกระดับที่ระบุ ซึ่งก็คือราคาส่วนลดทันที ต้องน้อยกว่าหรือเท่ากับราคาปกติ
`cashback_for_future_use`	`Price` เงินคืนที่นำไปใช้ในการซื้อในอนาคตได้
`loyalty_points`	`int64` จำนวนคะแนนสะสมที่ได้รับจากการซื้อ
`member_price_effective_date`	`Interval` ช่วงวันที่ที่สินค้ามีสิทธิ์ใช้ราคาสำหรับสมาชิก หากไม่ได้ระบุ ระบบจะใช้ราคาสำหรับสมาชิกเสมอ ช่วงวันที่แสดงด้วยคู่วันที่ ISO 8601 ที่เว้นวรรคด้วยคอมมาหรือเครื่องหมายทับ
`shipping_label`	`string` ป้ายกำกับสิทธิประโยชน์ในการจัดส่ง หากช่องมีค่า ข้อเสนอนี้จะมีสิทธิประโยชน์ในการจัดส่งตามโปรแกรมสะสมคะแนน หากไม่ได้ระบุค่าในช่อง สินค้าจะไม่มีสิทธิ์ใช้การจัดส่งตามโปรแกรมสะสมคะแนนสำหรับระดับการเป็นสมาชิกที่ระบุ

ผลิตภัณฑ์

ผลิตภัณฑ์ที่ประมวลผลแล้ว ซึ่งสร้างจากproduct inputsหลายรายการหลังจากใช้กฎและแหล่งข้อมูลเสริม ผลิตภัณฑ์ที่ประมวลผลนี้จะตรงกับสิ่งที่แสดงในบัญชี Merchant Center, โฆษณา Shopping และแพลตฟอร์มอื่นๆ ของ Google ผลิตภัณฑ์แต่ละรายการสร้างขึ้นจากอินพุตผลิตภัณฑ์แหล่งข้อมูลหลักเพียงรายการเดียว และอินพุตแหล่งข้อมูลเสริมหลายรายการ หลังจากแทรก อัปเดต หรือลบอินพุตผลิตภัณฑ์แล้ว ระบบอาจใช้เวลา 2-3 นาทีก่อนที่จะเรียกดูผลิตภัณฑ์ที่ประมวลผลแล้วซึ่งอัปเดตแล้วได้

ช่องทั้งหมดในผลิตภัณฑ์ที่ประมวลผลและข้อความย่อยของผลิตภัณฑ์นั้นตรงกับชื่อแอตทริบิวต์ที่เกี่ยวข้องในข้อกำหนดในการจัดทำข้อมูลผลิตภัณฑ์ โดยมีข้อยกเว้นบางประการ

ช่อง
`name`	`string` ชื่อผลิตภัณฑ์ รูปแบบ: `"{product.name=accounts/{account}/products/{product}}"` โดยส่วนที่ `product` สุดท้ายประกอบด้วย 4 ส่วน ได้แก่ channel~content_language~feed_label~offer_id ตัวอย่างชื่อผลิตภัณฑ์คือ "accounts/123/products/online~en~US~sku123"
`channel`	`ChannelEnum` เอาต์พุตเท่านั้น ช่องทางของผลิตภัณฑ์
`offer_id`	`string` เอาต์พุตเท่านั้น ตัวระบุที่ไม่ซ้ำกันสำหรับผลิตภัณฑ์ ซึ่งจะเหมือนกันสำหรับข้อมูลผลิตภัณฑ์และผลิตภัณฑ์ที่ประมวลผลแล้ว ระบบจะนำช่องว่างขึ้นต้นและต่อท้ายออก และจะแทนที่ช่องว่างหลายช่องด้วยช่องว่างเดี่ยวเมื่อส่ง ดูรายละเอียดได้ในข้อกำหนดในการจัดทำข้อมูลผลิตภัณฑ์
`content_language`	`string` เอาต์พุตเท่านั้น รหัสภาษา ISO 639-1 แบบ 2 ตัวอักษรสำหรับผลิตภัณฑ์
`feed_label`	`string` เอาต์พุตเท่านั้น ป้ายกำกับฟีดของผลิตภัณฑ์
`data_source`	`string` เอาต์พุตเท่านั้น แหล่งข้อมูลหลักของผลิตภัณฑ์
`attributes`	`Attributes` เอาต์พุตเท่านั้น รายการแอตทริบิวต์ผลิตภัณฑ์
`custom_attributes[]`	`CustomAttribute` เอาต์พุตเท่านั้น รายการแอตทริบิวต์ที่กำหนดเอง (ผู้ขายระบุ) นอกจากนี้ยังใช้เพื่อส่งแอตทริบิวต์ของข้อกำหนดเฉพาะของข้อมูลในรูปแบบทั่วไปได้ด้วย (เช่น `{ "name": "size type", "value": "regular" }`) ซึ่งมีประโยชน์สำหรับการส่งแอตทริบิวต์ที่ API ไม่ได้แสดงอย่างชัดเจน เช่น แอตทริบิวต์เพิ่มเติมที่ใช้สำหรับ "ซื้อใน Google"
`product_status`	`ProductStatus` เอาต์พุตเท่านั้น สถานะของผลิตภัณฑ์ ปัญหาการตรวจสอบข้อมูล ซึ่งก็คือข้อมูลเกี่ยวกับผลิตภัณฑ์ที่ประมวลผลแบบไม่พร้อมกัน
`version_number`	`int64` เอาต์พุตเท่านั้น แสดงเวอร์ชันที่มีอยู่ (ความใหม่) ของผลิตภัณฑ์ ซึ่งสามารถใช้เพื่อรักษาลำดับที่ถูกต้องเมื่อมีการอัปเดตหลายรายการพร้อมกัน หากตั้งค่าไว้ ระบบจะป้องกันไม่ให้แทรกเมื่อหมายเลขเวอร์ชันต่ำกว่าหมายเลขเวอร์ชันปัจจุบันของผลิตภัณฑ์ที่มีอยู่ คุณสามารถแทรกผลิตภัณฑ์อีกครั้ง (เช่น รีเฟรชผลิตภัณฑ์หลังจากผ่านไป 30 วัน) โดยใช้ `version_number` ปัจจุบัน รองรับเฉพาะการแทรกลงในแหล่งข้อมูลหลัก หากมีการป้องกันการดําเนินการ ระบบจะแสดงข้อยกเว้นที่ยกเลิก

ProductDetail

รายละเอียดผลิตภัณฑ์

ช่อง

ช่อง
`section_name`	`string` ส่วนหัวของส่วนที่ใช้จัดกลุ่มชุดรายละเอียดผลิตภัณฑ์
`attribute_name`	`string` ชื่อของรายละเอียดผลิตภัณฑ์
`attribute_value`	`string` ค่าของรายละเอียดผลิตภัณฑ์

section_name

string

ส่วนหัวของส่วนที่ใช้จัดกลุ่มชุดรายละเอียดผลิตภัณฑ์

attribute_name

string

ชื่อของรายละเอียดผลิตภัณฑ์

attribute_value

string

ค่าของรายละเอียดผลิตภัณฑ์

ProductDimension

ขนาดของผลิตภัณฑ์

ช่อง

ช่อง
`value`	`double` ต้องระบุ ค่ามิติข้อมูลที่แสดงเป็นตัวเลข ค่ามีความแม่นยำสูงสุด 4 ตำแหน่งทศนิยม
`unit`	`string` ต้องระบุ หน่วยของมิติข้อมูล ค่าที่ยอมรับได้คือ * "`in`" * "`cm`"

value

double

ต้องระบุ ค่ามิติข้อมูลที่แสดงเป็นตัวเลข ค่ามีความแม่นยำสูงสุด 4 ตำแหน่งทศนิยม

unit

string

ต้องระบุ หน่วยของมิติข้อมูล ค่าที่ยอมรับได้คือ * "in" * "cm"

ProductInput

แหล่งข้อมูลนี้แสดงข้อมูลอินพุตที่คุณส่งสำหรับผลิตภัณฑ์ ไม่ใช่ผลิตภัณฑ์ที่ประมวลผลแล้วซึ่งคุณเห็นใน Merchant Center, ในโฆษณา Shopping หรือในแพลตฟอร์มของ Google ระบบจะรวมข้อมูลอินพุตของผลิตภัณฑ์ กฎ และแหล่งข้อมูลเสริมเข้าด้วยกันเพื่อสร้าง Product ที่ประมวลผลแล้ว

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

แอตทริบิวต์ที่ต้องระบุ ได้แก่ feedLabel, contentLanguage และ offerId

ช่องทั้งหมดในอินพุตผลิตภัณฑ์และข้อความย่อยของผลิตภัณฑ์ต้องตรงกับชื่อภาษาอังกฤษของแอตทริบิวต์ที่เกี่ยวข้องในข้อกำหนดเฉพาะของประเภทธุรกิจ โดยมีข้อยกเว้นบางประการ

ช่อง
`name`	`string` ตัวระบุ ชื่อของอินพุตผลิตภัณฑ์ รูปแบบ: `"{productinput.name=accounts/{account}/productInputs/{productinput}}"` โดยที่ส่วนสุดท้าย `productinput` ประกอบด้วย 4 ส่วน ได้แก่ channel~content_language~feed_label~offer_id ตัวอย่างชื่ออินพุตผลิตภัณฑ์คือ "accounts/123/productInputs/online~en~US~sku123"
`product`	`string` เอาต์พุตเท่านั้น ชื่อผลิตภัณฑ์แปรรูป รูปแบบ: `"{product.name=accounts/{account}/products/{product}}"`
`channel`	`ChannelEnum` เปลี่ยนแปลงไม่ได้ ช่องทางของผลิตภัณฑ์
`offer_id`	`string` ต้องระบุ เปลี่ยนแปลงไม่ได้ ตัวระบุที่ไม่ซ้ำกันสำหรับผลิตภัณฑ์ ซึ่งจะเหมือนกันสำหรับข้อมูลผลิตภัณฑ์และผลิตภัณฑ์ที่ประมวลผลแล้ว ระบบจะนำช่องว่างขึ้นต้นและต่อท้ายออก และจะแทนที่ช่องว่างหลายช่องด้วยช่องว่างเดี่ยวเมื่อส่ง ดูรายละเอียดได้ในข้อกำหนดในการจัดทำข้อมูลผลิตภัณฑ์
`content_language`	`string` ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสภาษา ISO 639-1 แบบ 2 ตัวอักษรสำหรับผลิตภัณฑ์
`feed_label`	`string` ต้องระบุ เปลี่ยนแปลงไม่ได้ ป้ายกำกับฟีดของผลิตภัณฑ์
`attributes`	`Attributes` ไม่บังคับ รายการแอตทริบิวต์ผลิตภัณฑ์
`custom_attributes[]`	`CustomAttribute` ไม่บังคับ รายการแอตทริบิวต์ที่กำหนดเอง (ผู้ขายระบุ) นอกจากนี้ยังใช้ส่งแอตทริบิวต์ของข้อกำหนดข้อมูลในรูปแบบทั่วไป (เช่น `{ "name": "size type", "value": "regular" }`) ได้ด้วย ซึ่งมีประโยชน์สำหรับการส่งแอตทริบิวต์ที่ API ไม่ได้แสดงอย่างชัดเจน เช่น แอตทริบิวต์เพิ่มเติมที่ใช้สำหรับ "ซื้อใน Google" จำนวนอักขระสูงสุดที่อนุญาตสำหรับแอตทริบิวต์ที่กำหนดเองแต่ละรายการคือ 10240 (แสดงผลรวมของอักขระสำหรับชื่อและค่า) คุณตั้งค่าแอตทริบิวต์ที่กำหนดเองได้สูงสุด 2, 500 รายการต่อผลิตภัณฑ์ โดยมีขนาดรวมไม่เกิน 102.4 KB ระบบจะแทนที่ขีดล่างในชื่อแอตทริบิวต์ที่กำหนดเองด้วยเว้นวรรคเมื่อแทรก
`version_number`	`int64` ไม่บังคับ แสดงเวอร์ชันที่มีอยู่ (ความใหม่) ของผลิตภัณฑ์ ซึ่งสามารถใช้เพื่อรักษาลำดับที่ถูกต้องเมื่อมีการอัปเดตหลายรายการพร้อมกัน หากตั้งค่าไว้ ระบบจะป้องกันไม่ให้แทรกเมื่อหมายเลขเวอร์ชันต่ำกว่าหมายเลขเวอร์ชันปัจจุบันของผลิตภัณฑ์ที่มีอยู่ คุณสามารถแทรกผลิตภัณฑ์อีกครั้ง (เช่น รีเฟรชผลิตภัณฑ์หลังจากผ่านไป 30 วัน) โดยใช้ `version_number` ปัจจุบัน รองรับเฉพาะการแทรกลงในแหล่งข้อมูลหลัก หากมีการป้องกันการดําเนินการ ระบบจะแสดงข้อยกเว้นที่ยกเลิก

ProductStatus

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

ช่อง
`destination_statuses[]`	`DestinationStatus` ปลายทางที่ต้องการสำหรับผลิตภัณฑ์
`item_level_issues[]`	`ItemLevelIssue` รายการปัญหาทั้งหมดที่เกี่ยวข้องกับผลิตภัณฑ์
`creation_date`	`Timestamp` วันที่สร้างรายการในรูปแบบ ISO 8601
`last_update_date`	`Timestamp` วันที่อัปเดตรายการล่าสุดในรูปแบบ ISO 8601
`google_expiration_date`	`Timestamp` วันที่สินค้าหมดอายุในรูปแบบ ISO 8601

DestinationStatus

สถานะปลายทางของสถานะผลิตภัณฑ์

ช่อง
`reporting_context`	`ReportingContextEnum` ชื่อของบริบทการรายงาน
`approved_countries[]`	`string` รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่ข้อเสนอได้รับอนุมัติ
`pending_countries[]`	`string` รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่ข้อเสนอรอการอนุมัติ
`disapproved_countries[]`	`string` รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่ข้อเสนอไม่ได้รับอนุมัติ

ItemLevelIssue

ItemLevelIssue ของสถานะผลิตภัณฑ์

ช่อง
`code`	`string` รหัสข้อผิดพลาดของปัญหา
`severity`	`Severity` ปัญหานี้ส่งผลต่อการแสดงข้อเสนออย่างไร
`resolution`	`string` ผู้ขายสามารถแก้ไขปัญหาได้หรือไม่
`attribute`	`string` ชื่อแอตทริบิวต์ หากปัญหาเกิดจากแอตทริบิวต์รายการเดียว
`reporting_context`	`ReportingContextEnum` บริบทการรายงานที่มีปัญหา
`description`	`string` คำอธิบายปัญหาสั้นๆ เป็นภาษาอังกฤษ
`detail`	`string` คำอธิบายปัญหาโดยละเอียดเป็นภาษาอังกฤษ
`documentation`	`string` URL ของหน้าเว็บเพื่อช่วยแก้ไขปัญหานี้
`applicable_countries[]`	`string` รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่มีปัญหากับข้อเสนอ

ความรุนแรง

ปัญหาส่งผลต่อการแสดงผลิตภัณฑ์อย่างไร

Enum
`SEVERITY_UNSPECIFIED`	ไม่ได้ระบุ
`NOT_IMPACTED`	ปัญหานี้แสดงถึงคำเตือนและจะไม่ส่งผลโดยตรงต่อผลิตภัณฑ์
`DEMOTED`	ผลิตภัณฑ์ถูกลดระดับและมีแนวโน้มที่จะมีประสิทธิภาพที่จำกัดในผลการค้นหา
`DISAPPROVED`	ปัญหาทำให้ผลิตภัณฑ์ไม่ได้รับอนุมัติ

ProductStructuredDescription

รายละเอียดที่มีโครงสร้างสำหรับคำอธิบายที่สร้างขึ้นโดยอัลกอริทึม (AI)

ช่อง

ช่อง
`digital_source_type`	`string` ประเภทแหล่งที่มาดิจิทัล เช่น "trained_algorithmic_media" เป็นไปตาม IPTC ความยาวสูงสุด 40 อักขระ
`content`	`string` ความยาวสูงสุดของข้อความคําอธิบายคือ 5,000 อักขระ

digital_source_type

string

ประเภทแหล่งที่มาดิจิทัล เช่น "trained_algorithmic_media" เป็นไปตาม IPTC ความยาวสูงสุด 40 อักขระ

content

string

ความยาวสูงสุดของข้อความคําอธิบายคือ 5,000 อักขระ

ProductStructuredTitle

ชื่อที่มีโครงสร้างสำหรับชื่อที่สร้างขึ้นโดยอัลกอริทึม (AI)

ช่อง

ช่อง
`digital_source_type`	`string` ประเภทแหล่งที่มาดิจิทัล เช่น "trained_algorithmic_media" เป็นไปตาม IPTC ความยาวสูงสุด 40 อักขระ
`content`	`string` ความยาวสูงสุดของข้อความชื่อคือ 150 อักขระ

digital_source_type

string

content

string

ความยาวสูงสุดของข้อความชื่อคือ 150 อักขระ

ProductSustainabilityIncentive

ข้อมูลเกี่ยวกับโปรแกรมสิ่งจูงใจที่เกี่ยวข้องกับความยั่งยืน เช่น เงินคืนหรือการลดหย่อนภาษี

ช่อง
ฟิลด์สหภาพ `value` มูลค่าสิ่งจูงใจด้านความยั่งยืน `value` ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
`amount`	`Price` จํานวนเงินคงที่ของสิ่งจูงใจ
`percentage`	`double` เปอร์เซ็นต์ของราคาลดที่มีการใช้สิ่งจูงใจ
`type`	`Type` โปรแกรมสิ่งจูงใจด้านความยั่งยืน

ประเภท

ประเภทของโปรแกรมจูงใจด้านความยั่งยืนที่รองรับ

Enum
`TYPE_UNSPECIFIED`	ประเภทสิ่งจูงใจด้านความยั่งยืนที่ไม่ระบุหรือไม่รู้จัก
`EV_TAX_CREDIT`	โปรแกรมที่ลดภาระภาษีสำหรับยานพาหนะไฟฟ้าและปลั๊กอินไฮบริดในบางประเทศ โดยส่วนลดเหล่านี้อาจอิงตามจำนวนเงินที่เฉพาะเจาะจงหรือเปอร์เซ็นต์ของราคาลด
`EV_PRICE_DISCOUNT`	โปรแกรมเงินอุดหนุน ซึ่งมักเรียกว่าโบนัสด้านสิ่งแวดล้อม ให้เงินสนับสนุนการซื้อรถยนต์ไฟฟ้าและปลั๊กอินไฮบริดในบางประเทศ โดยจำนวนเงินทุนสนับสนุนอาจเป็นจํานวนเงินคงที่หรือเป็นเปอร์เซ็นต์ของราคาลด

ProductWeight

น้ำหนักของผลิตภัณฑ์

ช่อง

ช่อง
`value`	`double` ต้องระบุ น้ำหนักที่แสดงเป็นตัวเลข น้ำหนักมีความแม่นยำได้สูงสุด 4 ตำแหน่งทศนิยม
`unit`	`string` ต้องระบุ หน่วยน้ำหนัก ค่าที่ยอมรับได้ ได้แก่ * "`g`" * "`kg`" * "`oz`" * "`lb`"

value

double

ต้องระบุ น้ำหนักที่แสดงเป็นตัวเลข น้ำหนักมีความแม่นยำได้สูงสุด 4 ตำแหน่งทศนิยม

unit

string

ต้องระบุ หน่วยน้ำหนัก ค่าที่ยอมรับได้ ได้แก่ * "g" * "kg" * "oz" * "lb"

การจัดส่ง

การจัดส่งผลิตภัณฑ์

ช่อง
`price`	`Price` ราคาจัดส่งแบบคงที่ที่แสดงเป็นตัวเลข
`country`	`string` รหัสเขตแดน CLDR ของประเทศที่จะจัดส่งสินค้า
`region`	`string` ภูมิภาคทางภูมิศาสตร์ที่มีอัตราค่าจัดส่ง ดูข้อมูลเพิ่มเติมได้ที่region
`service`	`string` คำอธิบายระดับบริการหรือความเร็วในการจัดส่งแบบอิสระ
`location_id`	`int64` รหัสตัวเลขของสถานที่ตั้งที่มีอัตราค่าจัดส่งตามที่ระบุไว้ใน AdWords API
`location_group_name`	`string` สถานที่ที่สามารถใช้การจัดส่งได้ ซึ่งแสดงด้วยชื่อกลุ่มสถานที่ตั้ง
`postal_code`	`string` ช่วงรหัสไปรษณีย์ที่มีอัตราค่าจัดส่ง ซึ่งแสดงด้วยรหัสไปรษณีย์ รหัสนำหน้ารหัสไปรษณีย์ตามด้วยไวลด์การ์ด * ช่วงระหว่างรหัสไปรษณีย์ 2 รหัสหรือรหัสนำหน้ารหัสไปรษณีย์ 2 รายการที่มีความยาวเท่ากัน
`min_handling_time`	`int64` วันทำการขั้นต่ำก่อนจัดส่ง (รวม) นับตั้งแต่ได้รับคำสั่งซื้อจนถึงวันที่จัดส่ง 0 หมายความว่ามีการจัดส่งคำสั่งซื้อในวันเดียวกันกับที่ได้รับคำสั่งซื้อหากคำสั่งซื้อดังกล่าวเกิดขึ้นก่อนเวลาปิดรับคำสั่งซื้อ `minHandlingTime` จะปรากฏได้เฉพาะกับ `maxHandlingTime` เท่านั้น แต่ไม่จำเป็นต้องมีหากมี `maxHandlingTime` อยู่
`max_handling_time`	`int64` วันทำการสูงสุดก่อนจัดส่ง (รวม) นับจากวันที่ได้รับคำสั่งซื้อจนถึงวันที่จัดส่ง 0 หมายความว่ามีการจัดส่งคำสั่งซื้อในวันเดียวกับที่ได้รับคำสั่งซื้อหากคำสั่งซื้อดังกล่าวเกิดขึ้นก่อนเวลาปิดรับคำสั่งซื้อ ต้องระบุทั้ง `maxHandlingTime` และ `maxTransitTime` หากระบุความเร็วในการจัดส่ง คุณจะระบุ `minHandlingTime` หรือไม่ก็ได้หากมี `maxHandlingTime` อยู่
`min_transit_time`	`int64` เวลาขนส่งขั้นต่ำ (รวม) นับตั้งแต่ที่มีการจัดส่งคำสั่งซื้อจนถึงเวลาที่นำส่งคำสั่งซื้อเป็นจำนวนวันทำการ 0 หมายความว่าคำสั่งซื้อได้รับการนำส่งในวันเดียวกับที่จัดส่ง `minTransitTime` จะปรากฏได้เฉพาะกับ `maxTransitTime` เท่านั้น แต่ไม่จำเป็นต้องมีหากมี `maxTransitTime` อยู่
`max_transit_time`	`int64` เวลาขนส่งสูงสุด (รวม) ตั้งแต่เวลาที่จัดส่งคำสั่งซื้อจนถึงเวลาที่นำส่งคำสั่งซื้อเป็นจำนวนวันทำการ 0 หมายความว่าคำสั่งซื้อได้รับการนำส่งในวันเดียวกับที่จัดส่ง ต้องระบุทั้ง `maxHandlingTime` และ `maxTransitTime` หากระบุความเร็วในการจัดส่ง คุณจะระบุ `minTransitTime` หรือไม่ก็ได้หากมี `maxTransitTime` อยู่

ShippingDimension

ShippingDimension ของผลิตภัณฑ์

ช่อง

ช่อง
`value`	`double` ขนาดของผลิตภัณฑ์ที่ใช้ในการคำนวณค่าจัดส่งของสินค้า
`unit`	`string` หน่วยของมูลค่า

value

double

ขนาดของผลิตภัณฑ์ที่ใช้ในการคำนวณค่าจัดส่งของสินค้า

unit

string

หน่วยของมูลค่า

ShippingWeight

ShippingWeight ของผลิตภัณฑ์

ช่อง

ช่อง
`value`	`double` น้ำหนักของผลิตภัณฑ์ที่ใช้ในการคำนวณค่าจัดส่งของสินค้า
`unit`	`string` หน่วยของมูลค่า

value

double

น้ำหนักของผลิตภัณฑ์ที่ใช้ในการคำนวณค่าจัดส่งของสินค้า

unit

string

หน่วยของมูลค่า

SubscriptionCost

SubscriptionCost ของผลิตภัณฑ์

ช่อง

ช่อง
`period`	`SubscriptionPeriod` ประเภทระยะเวลาการสมัครใช้บริการ ค่าที่รองรับมีดังนี้ * "`month`" * "`year`"
`period_length`	`int64` จำนวนระยะเวลาการสมัครใช้บริการที่ผู้ซื้อต้องชำระ
`amount`	`Price` จํานวนเงินที่ผู้ซื้อต้องชําระต่อระยะเวลาการสมัครใช้บริการ

period

SubscriptionPeriod

ประเภทระยะเวลาการสมัครใช้บริการ ค่าที่รองรับมีดังนี้ * "month" * "year"

period_length

int64

จำนวนระยะเวลาการสมัครใช้บริการที่ผู้ซื้อต้องชำระ

amount

Price

จํานวนเงินที่ผู้ซื้อต้องชําระต่อระยะเวลาการสมัครใช้บริการ

SubscriptionPeriod

ระยะเวลาการสมัครใช้บริการของผลิตภัณฑ์

Enum
`SUBSCRIPTION_PERIOD_UNSPECIFIED`	บ่งบอกว่าไม่ได้ระบุระยะเวลาการสมัครใช้บริการ
`MONTH`	ระบุว่าระยะเวลาการสมัครใช้บริการคือเดือน
`YEAR`	ระบุว่าระยะเวลาการสมัครใช้บริการคือปี

ภาษี

ภาษีของผลิตภัณฑ์

ช่อง
`rate`	`double` เปอร์เซ็นต์ของอัตราภาษีที่มีผลกับราคาสินค้า
`country`	`string` ประเทศที่มีการจัดเก็บภาษีสินค้า ซึ่งระบุเป็นรหัสเขตแดน CLDR
`region`	`string` ภูมิภาคทางภูมิศาสตร์ที่มีอัตราภาษี
`tax_ship`	`bool` ตั้งค่าเป็น "จริง" หากมีการเรียกเก็บภาษีในการจัดส่ง
`location_id`	`int64` รหัสตัวเลขของสถานที่ตั้งที่มีอัตราภาษีตามที่ระบุไว้ใน AdWords API
`postal_code`	`string` ช่วงรหัสไปรษณีย์ที่มีอัตราภาษีมีผลบังคับใช้ ซึ่งแสดงด้วยรหัสไปรษณีย์ รหัสนำหน้ารหัสไปรษณีย์ที่ใช้ไวลด์การ์ด * ช่วงระหว่างรหัสไปรษณีย์ 2 รหัส หรือรหัสนำหน้ารหัสไปรษณีย์ 2 รายการที่มีความยาวเท่ากัน ตัวอย่างเช่น 94114, 94, 94002-95460, 94-95*

UnitPricingBaseMeasure

UnitPricingBaseMeasure ของผลิตภัณฑ์

ช่อง

ช่อง
`value`	`int64` ตัวส่วนราคาต่อหน่วย
`unit`	`string` หน่วยของตัวหาร

value

int64

ตัวส่วนราคาต่อหน่วย

unit

string

หน่วยของตัวหาร

UnitPricingMeasure

UnitPricingMeasure ของผลิตภัณฑ์

ช่อง

ช่อง
`value`	`double` การวัดของสินค้า
`unit`	`string` หน่วยของข้อมูล

value

double

การวัดของสินค้า

unit

string

หน่วยของข้อมูล