REST Resource: accounts.products

แหล่งข้อมูล: ผลิตภัณฑ์

ผลิตภัณฑ์ที่ประมวลผลแล้วซึ่งสร้างขึ้นจาก [อินพุตผลิตภัณฑ์][[google.shopping.content.bundles.Products.ProductInput] หลายรายการหลังจากใช้กฎและแหล่งข้อมูลเสริม ผลิตภัณฑ์ที่ประมวลผลแล้วนี้ตรงกับข้อมูลที่แสดงในบัญชี Merchant Center รวมถึงในโฆษณา Shopping และแพลตฟอร์มอื่นๆ ของ Google ผลิตภัณฑ์แต่ละรายการสร้างขึ้นจากข้อมูลผลิตภัณฑ์ในแหล่งข้อมูลหลัก 1 รายการเท่านั้น และข้อมูลเสริมของแหล่งข้อมูลเสริมหลายรายการ หลังจากแทรก อัปเดต หรือลบผลิตภัณฑ์ที่ป้อนแล้ว อาจใช้เวลาหลายนาทีกว่าระบบจะดึงข้อมูลผลิตภัณฑ์ที่ประมวลผลที่อัปเดตแล้วได้

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

การแสดง JSON 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
ช่อง
name

string

ชื่อผลิตภัณฑ์ รูปแบบ: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

เอาต์พุตเท่านั้น ช่องทางของผลิตภัณฑ์
offerId

string

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

string

เอาต์พุตเท่านั้น รหัสภาษา ISO 639-1 แบบ 2 ตัวอักษรสำหรับผลิตภัณฑ์
feedLabel

string

เอาต์พุตเท่านั้น ป้ายกำกับฟีดสำหรับผลิตภัณฑ์
dataSource

string

เอาต์พุตเท่านั้น แหล่งข้อมูลหลักของผลิตภัณฑ์
attributes

object (Attributes)

เอาต์พุตเท่านั้น รายการแอตทริบิวต์ผลิตภัณฑ์
customAttributes[]

object (CustomAttribute)

เอาต์พุตเท่านั้น รายการแอตทริบิวต์ที่กำหนดเอง (ระบุโดยผู้ขาย) นอกจากนี้ ยังใช้เพื่อส่งแอตทริบิวต์ของข้อกำหนดในการจัดทำข้อมูลในรูปแบบทั่วไป (เช่น { "name": "size type", "value": "regular" }) ได้ด้วย การดำเนินการนี้มีประโยชน์สำหรับการส่งแอตทริบิวต์ที่ API ไม่ได้เปิดเผยอย่างชัดเจน เช่น แอตทริบิวต์เพิ่มเติมที่ใช้สำหรับ "ซื้อใน Google"
productStatus

object (ProductStatus)

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

string (int64 format)

เอาต์พุตเท่านั้น แสดงถึงผลิตภัณฑ์เวอร์ชันที่มีอยู่ (ความใหม่) ซึ่งใช้เพื่อรักษาลำดับที่เหมาะสมเมื่ออัปเดตหลายรายการพร้อมกัน

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

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

หากมีการป้องกันการดำเนินการ ข้อยกเว้นที่ล้มเลิกจะถูกยกเลิก

Attributes

แอตทริบิวต์

การแสดง JSON 
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "gtin": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
ช่อง
expirationDate

string (Timestamp format)

วันที่ที่รายการควรหมดอายุตามที่ระบุไว้ในรูปแบบ ISO 8601 วันที่หมดอายุจริงจะแสดงใน productstatuses เป็น googleExpirationDate และอาจเร็วกว่านี้หาก expirationDate อยู่ไกลจากปัจจุบันเกินไป
disclosureDate

string (Timestamp format)

วันที่ที่ข้อเสนอปรากฏในผลการค้นหาบนแพลตฟอร์มต่างๆ ของ YouTube บน YouTube ในรูปแบบ ISO 8601 ดูข้อมูลเพิ่มเติมได้ที่[วันที่เปิดเผย]( https://support.google.com/merchants/answer/13034208)
availabilityDate

string (Timestamp format)

วันที่พร้อมนำส่งผลิตภัณฑ์ที่สั่งจองล่วงหน้าในรูปแบบ ISO 8601
price

object (Price)

ราคาของสินค้า
installment

object (Installment)

จำนวนและจำนวนเงินการผ่อนชำระที่จะชำระสำหรับสินค้า
subscriptionCost

object (SubscriptionCost)

จำนวนงวด (เดือนหรือปี) และจำนวนเงินที่ชำระต่องวดสำหรับรายการที่มีสัญญาการสมัครใช้บริการที่เกี่ยวข้อง
loyaltyPoints

object (LoyaltyPoints)

คะแนนสะสมที่ผู้ใช้จะได้รับหลังจากซื้อสินค้า ญี่ปุ่นเท่านั้น
loyaltyPrograms[]

object (LoyaltyProgram)

รายการข้อมูลโปรแกรมสะสมคะแนนที่ใช้เพื่อแสดงสิทธิประโยชน์ของการสะสมคะแนน (เช่น ราคาที่ดีขึ้น คะแนน ฯลฯ) แก่ผู้ใช้ของรายการนี้
productTypes[]

string

หมวดหมู่สินค้า (จัดรูปแบบในข้อกำหนดในการจัดทำข้อมูลผลิตภัณฑ์)
salePrice

object (Price)

ราคาลดที่โฆษณาของสินค้า
salePriceEffectiveDate

object (Interval)

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

object (ProductDimension)

ความสูงของผลิตภัณฑ์ในหน่วยที่ให้ ค่าต้องอยู่ระหว่าง 0 (ไม่รวม) ถึง 3000 (รวม)
productLength

object (ProductDimension)

ความยาวของผลิตภัณฑ์ในหน่วยที่ให้ ค่าต้องอยู่ระหว่าง 0 (ไม่รวม) ถึง 3000 (รวม)
productWidth

object (ProductDimension)

ความกว้างของผลิตภัณฑ์ในหน่วยที่ให้ ค่าต้องอยู่ระหว่าง 0 (ไม่รวม) ถึง 3000 (รวม)
productWeight

object (ProductWeight)

น้ำหนักของผลิตภัณฑ์ในหน่วยที่ให้ ค่าต้องอยู่ระหว่าง 0 (ไม่รวม) ถึง 2000 (รวม)
shipping[]

object (Shipping)

กฎการจัดส่ง
freeShippingThreshold[]

object (FreeShippingThreshold)

เงื่อนไขที่ต้องปฏิบัติตามเพื่อให้ผลิตภัณฑ์มีการจัดส่งฟรี
shippingWeight

object (ShippingWeight)

น้ำหนักของสินค้าสำหรับการจัดส่ง
shippingLength

object (ShippingDimension)

ความยาวของสินค้าสำหรับการจัดส่ง
shippingWidth

object (ShippingDimension)

ความกว้างของสินค้าสำหรับการจัดส่ง
shippingHeight

object (ShippingDimension)

ความสูงของสินค้าสำหรับการจัดส่ง
sizeTypes[]

string

การตัดต่อของสินค้า โดยใช้เพื่อแสดงประเภทขนาดรวมสำหรับสินค้าประเภทเครื่องแต่งกาย คุณระบุประเภทขนาดได้สูงสุด 2 ประเภท (ดู[https://support.google.com/merchants/answer/6324497](ประเภทขนาด))
taxes[]

object (Tax)

ข้อมูลภาษี
unitPricingMeasure

object (UnitPricingMeasure)

หน่วยวัดและมิติข้อมูลของสินค้า
unitPricingBaseMeasure

object (UnitPricingBaseMeasure)

ค่ากำหนดตัวส่วนของราคาต่อหน่วย
adsLabels[]

string

คล้ายกับ adsGrouping แต่ทำงานเฉพาะกับ CPC
costOfGoodsSold

object (Price)

ต้นทุนสินค้าขาย ใช้สำหรับการรายงานกำไรขั้นต้น
productDetails[]

object (ProductDetail)

ข้อกำหนดทางเทคนิคหรือรายละเอียดผลิตภัณฑ์เพิ่มเติม
productHighlights[]

string

หัวข้อย่อยที่อธิบายไฮไลต์ที่เกี่ยวข้องกับผลิตภัณฑ์มากที่สุด
displayAdsSimilarIds[]

string

คำแนะนำที่ผู้ลงโฆษณาระบุ
promotionIds[]

string

รหัสที่ไม่ซ้ำกันของโปรโมชัน
includedDestinations[]

string

รายการปลายทางที่จะรวมสำหรับเป้าหมายนี้ (ตรงกับช่องทำเครื่องหมายที่เลือกไว้ใน Merchant Center) ระบบจะรวมปลายทางเริ่มต้นเสมอ เว้นแต่จะระบุใน excludedDestinations
excludedDestinations[]

string

รายการปลายทางที่จะยกเว้นสำหรับเป้าหมายนี้ (ตรงกับช่องทำเครื่องหมายที่ยกเลิกการเลือกแล้วใน Merchant Center)
shoppingAdsExcludedCountries[]

string

รายการรหัสประเทศ (ISO 3166-1 alpha-2) เพื่อยกเว้นข้อเสนอจากปลายทางโฆษณา Shopping ระบบจะนำประเทศจากรายการนี้ออกจากประเทศที่กำหนดค่าไว้ในการตั้งค่าแหล่งข้อมูล
cloudExportAdditionalProperties[]

object (CloudExportAdditionalProperties)

ช่องเพิ่มเติมสำหรับส่งออกไปยังโปรแกรม Cloud Retail
certifications[]

object (Certification)

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

object (Price)

การป้องกันในโปรเจ็กต์ "ส่วนลดอัตโนมัติ" (https://support.google.com/merchants/answer/10295759) และ "โปรโมชันแบบไดนามิก" (https://support.google.com/merchants/answer/13949249) เพื่อให้แน่ใจว่าส่วนลดข้อเสนอของผู้ขายจะไม่ต่ำกว่าค่านี้ ซึ่งจะช่วยรักษามูลค่าและผลกำไรของข้อเสนอไว้
identifierExists

boolean

ตั้งค่านี้เป็น "เท็จ" เมื่อสินค้าไม่มีรหัสระบุผลิตภัณฑ์ซึ่งเหมาะสมกับหมวดหมู่ของสินค้า เช่น GTIN, MPN และแบรนด์ ค่าเริ่มต้นจะเป็นจริง หากไม่ได้ระบุไว้
isBundle

boolean

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

string

ชื่อของสินค้า
description

string

รายละเอียดของสินค้า
adult

boolean

ตั้งค่าเป็น "จริง" หากมีการกำหนดเป้าหมายรายการเป็นผู้ใหญ่
ageGroup

string

กลุ่มอายุเป้าหมายของสินค้า
availability

string

สถานะความพร้อมจำหน่ายสินค้า
brand

string

แบรนด์ของสินค้า
color

string

สีของสินค้า
condition

string

สภาพสินค้าหรือสถานะของสินค้า
gender

string

เพศเป้าหมายของสินค้า
googleProductCategory

string

หมวดหมู่สินค้าของ Google (ดูการจัดหมวดหมู่ผลิตภัณฑ์ของ Google) เมื่อค้นหาผลิตภัณฑ์ ช่องนี้จะมีค่าที่ผู้ใช้ระบุ ปัจจุบันยังไม่มีวิธีดึงข้อมูลหมวดหมู่ผลิตภัณฑ์ Google ที่กำหนดโดยอัตโนมัติผ่าน API
gtin

string

หมายเลขสินค้าการค้าสากล (GTIN) ของสินค้า
itemGroupId

string

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

string

วัสดุที่ใช้ผลิตสินค้า
mpn

string

หมายเลขชิ้นส่วนของผู้ผลิต (MPN) สำหรับสินค้า
pattern

string

ลายของสินค้า (เช่น ลายจุด)
sellOnGoogleQuantity

string (int64 format)

จำนวนผลิตภัณฑ์ที่พร้อมจำหน่ายบน Google รองรับเฉพาะผลิตภัณฑ์ออนไลน์เท่านั้น
maxHandlingTime

string (int64 format)

วันทำการสูงสุดก่อนจัดส่งของผลิตภัณฑ์ (ในวันทำการ)
minHandlingTime

string (int64 format)

วันทำการขั้นต่ำก่อนจัดส่ง (ในวันทำการ)
shippingLabel

string

ป้ายกำกับการจัดส่งของผลิตภัณฑ์ที่ใช้ในการจัดกลุ่มผลิตภัณฑ์ในกฎการจัดส่งระดับบัญชี
transitTimeLabel

string

ป้ายกำกับเวลาขนส่งของผลิตภัณฑ์ซึ่งใช้ในการจัดกลุ่มผลิตภัณฑ์ในตารางเวลาขนส่งระดับบัญชี
size

string

ขนาดของสินค้า อนุญาตเพียงค่าเดียวเท่านั้น สำหรับผลิตภัณฑ์ย่อยที่มีขนาดต่างกัน ให้แทรกผลิตภัณฑ์แยกกันสำหรับแต่ละขนาดโดยใช้ค่า itemGroupId เดียวกัน (ดู[https://support.google.com/merchants/answer/6324492](การกำหนดขนาด))
sizeSystem

string

ระบบที่ระบุขนาด แนะนำสำหรับสินค้าเครื่องแต่งกาย
taxCategory

string

หมวดหมู่ภาษีของผลิตภัณฑ์ ซึ่งใช้เพื่อกำหนดค่าจุดเชื่อมโยงภาษีโดยละเอียดในการตั้งค่าภาษีระดับบัญชี
energyEfficiencyClass

string

ระดับการประหยัดพลังงานตามที่ระบุไว้ในข้อกำหนดของสหภาพยุโรป 2010/30/EU
minEnergyEfficiencyClass

string

ระดับการประหยัดพลังงานตามที่ระบุไว้ในข้อกำหนดของสหภาพยุโรป 2010/30/EU
maxEnergyEfficiencyClass

string

ระดับการประหยัดพลังงานตามที่ระบุไว้ในข้อกำหนดของสหภาพยุโรป 2010/30/EU
multipack

string (int64 format)

จำนวนของผลิตภัณฑ์ที่เหมือนกันในแพ็กใหญ่ที่ผู้ขายกำหนด
adsGrouping

string

ใช้เพื่อจัดกลุ่มรายการตามวิธีที่กำหนดเอง สำหรับ CPA% เท่านั้น ไม่แนะนำ
adsRedirect

string

อนุญาตให้ผู้ลงโฆษณาลบล้าง URL ของสินค้าเมื่อแสดงผลิตภัณฑ์ในบริบทของโฆษณาผลิตภัณฑ์ได้
displayAdsId

string

ตัวระบุสินค้าสำหรับแคมเปญรีมาร์เก็ตติ้งแบบไดนามิก
displayAdsTitle

string

ชื่อสินค้าสำหรับแคมเปญรีมาร์เก็ตติ้งแบบไดนามิก
displayAdsValue

number

อัตรากำไรของข้อเสนอสำหรับแคมเปญรีมาร์เก็ตติ้งแบบไดนามิก
pickupMethod

string

ตัวเลือกการรับสินค้า
pickupSla

string

ลำดับเวลาการมารับสินค้าที่ร้าน
customLabel0

string

ป้ายที่กำหนดเอง 0 สำหรับการจัดกลุ่มสินค้าที่กำหนดเองในแคมเปญ Shopping
customLabel1

string

ป้ายกำกับที่กำหนดเอง 1 สำหรับการจัดกลุ่มสินค้าที่กำหนดเองในแคมเปญ Shopping
customLabel2

string

ป้ายกำกับที่กำหนดเอง 2 สำหรับการจัดกลุ่มสินค้าที่กำหนดเองในแคมเปญ Shopping
customLabel3

string

ป้ายกำกับที่กำหนดเอง 3 สำหรับการจัดกลุ่มสินค้าที่กำหนดเองในแคมเปญ Shopping
customLabel4

string

ป้ายกำกับที่กำหนดเอง 4 สำหรับการจัดกลุ่มสินค้าที่กำหนดเองในแคมเปญ Shopping
externalSellerId

string

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

string

การเผยแพร่รายการนี้จะหยุดชั่วคราวชั่วคราว
structuredTitle

object (ProductStructuredTitle)

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

object (ProductStructuredDescription)

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

การผ่อนชำระ

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

การแสดง JSON 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
ช่อง
months

string (int64 format)

จำนวนงวดการผ่อนชำระที่ผู้ซื้อต้องชำระ
amount

object (Price)

จำนวนเงินที่ผู้ซื้อต้องชำระต่อเดือน
downpayment

object (Price)

จำนวนเงินที่ชำระล่วงหน้าที่ผู้ซื้อต้องจ่าย
creditType

string

ประเภทการผ่อนชำระ ค่าที่รองรับ ได้แก่ * "finance" * "lease"

SubscriptionCost

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

การแสดง JSON 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
ช่อง
period

enum (SubscriptionPeriod)

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

string (int64 format)

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

object (Price)

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

SubscriptionPeriod

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

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

LoyaltyPoints

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

การแสดง JSON 
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
ช่อง
name

string

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

string (int64 format)

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

number

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

LoyaltyProgram

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

การแสดง JSON 
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string
}
ช่อง
programLabel

string

ป้ายกำกับของโปรแกรมสะสมคะแนน นี่คือป้ายกำกับภายในที่ระบุความสัมพันธ์ระหว่างเอนทิตีผู้ขายกับเอนทิตีโปรแกรมสะสมคะแนนโดยไม่ซ้ำกัน คุณต้องระบุป้ายกำกับเพื่อให้ระบบเชื่อมโยงชิ้นงานด้านล่าง (เช่น ราคาและคะแนน) กับผู้ขายได้ โดยโปรแกรมที่เกี่ยวข้องต้องลิงก์กับบัญชีผู้ขาย
tierLabel

string

ป้ายกำกับของระดับภายในโปรแกรมสะสมคะแนน ต้องตรงกับป้ายกำกับรายการใดรายการหนึ่งภายในโปรแกรม
price

object (Price)

ราคาสำหรับสมาชิกของระดับที่กำหนด ซึ่งก็คือราคาส่วนลดทันที ต้องน้อยกว่าหรือเท่ากับราคาปกติ
cashbackForFutureUse

object (Price)

เงินคืนที่ใช้สำหรับการซื้อในอนาคตได้
loyaltyPoints

string (int64 format)

จำนวนคะแนนสะสมที่ได้รับจากการซื้อ

ProductDimension

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

การแสดง JSON 
{
  "value": number,
  "unit": string
}
ช่อง
value

number

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

string

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

ProductWeight

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

การแสดง JSON 
{
  "value": number,
  "unit": string
}
ช่อง
value

number

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

string

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

การจัดส่ง

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

การแสดง JSON 
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
ช่อง
price

object (Price)

ราคาจัดส่งคงที่ซึ่งแสดงเป็นตัวเลข
country

string

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

string

ภูมิภาคทางภูมิศาสตร์ที่มีอัตราค่าจัดส่ง ดูข้อมูลเพิ่มเติมได้ที่ภูมิภาค
service

string

คำอธิบายรูปแบบอิสระของคลาสบริการหรือความเร็วในการนำส่ง
locationId

string (int64 format)

รหัสตัวเลขของสถานที่ตั้งที่มีอัตราค่าจัดส่งตามที่ระบุใน AdWords API
locationGroupName

string

สถานที่ที่เกี่ยวข้องการจัดส่งซึ่งแสดงด้วยชื่อกลุ่มสถานที่ตั้ง
postalCode

string

ช่วงรหัสไปรษณีย์ที่ใช้อัตราค่าจัดส่ง ซึ่งจะแสดงด้วยรหัสไปรษณีย์ คำนำหน้ารหัสไปรษณีย์ ตามด้วยไวลด์การ์ด * ช่วงระหว่างรหัสไปรษณีย์ 2 รหัส หรือคำนำหน้ารหัสไปรษณีย์ 2 รหัสที่มีความยาวเท่ากัน
minHandlingTime

string (int64 format)

วันทำการขั้นต่ำก่อนจัดส่ง (รวม) ระหว่างที่ได้รับคำสั่งซื้อและจัดส่งในวันทำการ 0 หมายความว่าคำสั่งซื้อดังกล่าวได้รับการจัดส่งในวันเดียวกันกับที่ได้รับ หากคำสั่งซื้อเกิดขึ้นก่อนเวลาปิดรับคำสั่งซื้อ [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] จะแสดงร่วมกับ [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] ได้เท่านั้น หากมี [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]
maxHandlingTime

string (int64 format)

วันทำการสูงสุดก่อนจัดส่ง (รวม) ระหว่างที่ได้รับคำสั่งซื้อและจัดส่งในวันทำการ 0 หมายความว่าคำสั่งซื้อดังกล่าวได้รับการจัดส่งในวันเดียวกันกับที่ได้รับ หากคำสั่งซื้อเกิดขึ้นก่อนเวลาปิดรับคำสั่งซื้อ ต้องระบุทั้ง [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] และ [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] หากระบุความเร็วในการจัดส่ง คุณจะระบุ [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] หรือไม่ก็ได้ หากมี [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]
minTransitTime

string (int64 format)

เวลาขนส่งขั้นต่ำ (รวม) ตั้งแต่เวลาที่จัดส่งสินค้าที่สั่งซื้อจนถึงเวลาที่นำส่งภายในวันทำการ 0 หมายความว่าคำสั่งซื้อได้รับการนำส่งในวันเดียวกับที่จัดส่ง [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] จะแสดงร่วมกับ [maxtransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] ได้เท่านั้น แต่ไม่จำเป็นหากมี [maxtransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]
maxTransitTime

string (int64 format)

เวลาขนส่งสูงสุด (รวม) ตั้งแต่เวลาที่จัดส่งสินค้าที่สั่งซื้อและเวลาที่นำส่งภายในวันทำการ 0 หมายความว่าคำสั่งซื้อได้รับการนำส่งในวันเดียวกับที่จัดส่ง ต้องระบุทั้ง [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] และ [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] หากระบุความเร็วในการจัดส่ง คุณจะระบุ [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] หรือไม่ก็ได้ หากมี [maxtransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]

FreeShippingThreshold

เงื่อนไขที่ต้องปฏิบัติตามเพื่อให้ผลิตภัณฑ์มีการจัดส่งฟรี

การแสดง JSON 
{
  "country": string,
  "priceThreshold": {
    object (Price)
  }
}
ช่อง
country

string

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

object (Price)

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

ShippingWeight

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

การแสดง JSON 
{
  "value": number,
  "unit": string
}
ช่อง
value

number

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

string

หน่วยของค่า

ShippingDimension

มิติข้อมูลการจัดส่งของผลิตภัณฑ์

การแสดง JSON 
{
  "value": number,
  "unit": string
}
ช่อง
value

number

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

string

หน่วยของค่า

ภาษี

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

การแสดง JSON 
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
ช่อง
rate

number

เปอร์เซ็นต์ของอัตราภาษีที่ใช้กับราคาสินค้า
country

string

ประเทศที่มีการเก็บภาษีสินค้า ระบุเป็นรหัสเขตแดน CLDR
region

string

ภูมิภาคทางภูมิศาสตร์ที่มีอัตราภาษี
taxShip

boolean

ตั้งค่าเป็น "จริง" หากมีการเรียกเก็บภาษีในการจัดส่ง
locationId

string (int64 format)

รหัสตัวเลขของสถานที่ตั้งที่มีอัตราภาษีดังที่ระบุไว้ใน AdWords API
postalCode

string

ช่วงรหัสไปรษณีย์ที่ใช้อัตราภาษี ซึ่งแสดงด้วยรหัสไปรษณีย์ ตัวเลขนำหน้ารหัสไปรษณีย์ที่ใช้ไวลด์การ์ด * ช่วงระหว่างรหัสไปรษณีย์ 2 รหัส หรือตัวเลขนำหน้ารหัสไปรษณีย์ 2 รหัสที่มีความยาวเท่ากัน เช่น 94114, 94*, 94002-95460, 94*-95*

UnitPricingMeasure

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

การแสดง JSON 
{
  "value": number,
  "unit": string
}
ช่อง
value

number

มาตรวัดของสินค้า
unit

string

หน่วยของการวัด

UnitPricingBaseMeasure

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

การแสดง JSON 
{
  "value": string,
  "unit": string
}
ช่อง
value

string (int64 format)

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

string

หน่วยของตัวส่วน

ProductDetail

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

การแสดง JSON 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
ช่อง
sectionName

string

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

string

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

string

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

CloudExportAdditionalProperties

พร็อพเพอร์ตี้ผลิตภัณฑ์สำหรับ Cloud Retail API เช่น พร็อพเพอร์ตี้สำหรับผลิตภัณฑ์ทีวีอาจเป็น "ความละเอียดของหน้าจอ" หรือ "ขนาดหน้าจอ"

การแสดง JSON 
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
ช่อง
textValue[]

string

ค่าข้อความของพร็อพเพอร์ตี้ที่ระบุ เช่น "8K(UHD)" อาจเป็นค่าข้อความสำหรับผลิตภัณฑ์ทีวี ความซ้ำสูงสุดของค่านี้คือ 400 ค่าได้รับการจัดเก็บตามลำดับที่กำหนดเองแต่สอดคล้องกัน สตริงต้องมีขนาดไม่เกิน 256 อักขระ
intValue[]

string (int64 format)

ค่าจำนวนเต็มของพร็อพเพอร์ตี้ที่ระบุ เช่น 1080 สำหรับความละเอียดหน้าจอของผลิตภัณฑ์ทีวี ความซ้ำสูงสุดของค่านี้คือ 400 ค่าได้รับการจัดเก็บตามลำดับที่กำหนดเองแต่สอดคล้องกัน
floatValue[]

number

ค่าทศนิยมของพร็อพเพอร์ตี้ที่ระบุ ตัวอย่างเช่น สำหรับผลิตภัณฑ์ทีวี 1.2345 ความซ้ำสูงสุดของค่านี้คือ 400 ค่าได้รับการจัดเก็บตามลำดับที่กำหนดเองแต่สอดคล้องกัน
propertyName

string

ชื่อของพร็อพเพอร์ตี้ที่ระบุ เช่น "ความละเอียดของหน้าจอ" สำหรับผลิตภัณฑ์ทีวี สตริงต้องมีขนาดไม่เกิน 256 อักขระ
boolValue

boolean

ค่าบูลีนของพร็อพเพอร์ตี้ที่ระบุ เช่น "จริง" หรือ "เท็จ" สำหรับผลิตภัณฑ์ทีวี หากหน้าจอเป็น UHD
minValue

number

ค่าลอยตัวขั้นต่ำของพร็อพเพอร์ตี้ที่ระบุ เช่น ผลิตภัณฑ์ทีวี 1.00
maxValue

number

ค่าลอยตัวสูงสุดของพร็อพเพอร์ตี้ที่ระบุ เช่น สำหรับผลิตภัณฑ์ทีวี 100.00
unitCode

string

หน่วยของพร็อพเพอร์ตี้ที่ระบุ เช่น "พิกเซล" สำหรับผลิตภัณฑ์ทีวี ขนาดสตริงสูงสุดคือ 256B

การรับรอง

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

การแสดง JSON 
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
ช่อง
certificationAuthority

string

หน่วยงานที่รับรอง เช่น "European_Commission" ความยาวสูงสุด 2,000 อักขระ
certificationName

string

ชื่อของใบรับรอง เช่น "EPREL" ความยาวสูงสุด 2,000 อักขระ
certificationCode

string

รหัสการรับรอง ความยาวสูงสุด 2,000 อักขระ
certificationValue

string

ค่าการรับรอง (หรือที่เรียกว่าชั้นเรียน ระดับ หรือเกรด) เช่น "A+", "C", "gold" ความยาวสูงสุด 2,000 อักขระ

ProductStructuredTitle

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

การแสดง JSON 
{
  "digitalSourceType": string,
  "content": string
}
ช่อง
digitalSourceType

string

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

string

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

ProductStructuredDescription

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

การแสดง JSON 
{
  "digitalSourceType": string,
  "content": string
}
ช่อง
digitalSourceType

string

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

string

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

ProductStatus

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

การแสดง JSON 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
ช่อง
destinationStatuses[]

object (DestinationStatus)

ปลายทางที่ต้องการสำหรับผลิตภัณฑ์
itemLevelIssues[]

object (ItemLevelIssue)

รายการปัญหาทั้งหมดที่เกี่ยวข้องกับผลิตภัณฑ์
creationDate

string (Timestamp format)

วันที่สร้างรายการในรูปแบบ ISO 8601
lastUpdateDate

string (Timestamp format)

วันที่อัปเดตรายการครั้งล่าสุดในรูปแบบ ISO 8601
googleExpirationDate

string (Timestamp format)

วันที่ที่สินค้าหมดอายุในรูปแบบ ISO 8601

DestinationStatus

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

การแสดง JSON 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
ช่อง
reportingContext

enum (ReportingContextEnum)

ชื่อของบริบทการรายงาน
approvedCountries[]

string

รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่ข้อเสนอได้รับอนุมัติ
pendingCountries[]

string

รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่ข้อเสนอกำลังรอการอนุมัติ
disapprovedCountries[]

string

รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่ข้อเสนอไม่ได้รับอนุมัติ

ItemLevelIssue

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

การแสดง JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
ช่อง
code

string

รหัสข้อผิดพลาดของปัญหา
severity

enum (Severity)

ปัญหานี้ส่งผลต่อการแสดงข้อเสนออย่างไร
resolution

string

ผู้ขายแก้ไขปัญหาได้หรือไม่
attribute

string

ชื่อแอตทริบิวต์ หากปัญหาเกิดจากแอตทริบิวต์เดียว
reportingContext

enum (ReportingContextEnum)

บริบทการรายงานที่เป็นปัญหา
description

string

คำอธิบายปัญหาสั้นๆ เป็นภาษาอังกฤษ
detail

string

คำอธิบายปัญหาโดยละเอียดเป็นภาษาอังกฤษ
documentation

string

URL ของหน้าเว็บที่จะช่วยแก้ปัญหานี้ได้
applicableCountries[]

string

รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่เกี่ยวข้องกับข้อเสนอ

ความรุนแรง

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

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

วิธีการ

get

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

list

 แสดงรายการผลิตภัณฑ์ที่ประมวลผลแล้วในบัญชี Merchant Center