REST Resource: accounts.cssProducts

แหล่งข้อมูล: CssProduct

ผลิตภัณฑ์ CSS ที่ประมวลผลแล้ว

การแสดง JSON 
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
ช่อง
name

string

ชื่อผลิตภัณฑ์ CSS รูปแบบ: "accounts/{account}/cssProducts/{css_product}"
rawProvidedId

string

เอาต์พุตเท่านั้น ตัวระบุดิบที่ไม่ซ้ำกันสำหรับผลิตภัณฑ์
contentLanguage

string

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

string

เอาต์พุตเท่านั้น ป้ายกำกับฟีดของผลิตภัณฑ์
attributes

object (Attributes)

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

object (CustomAttribute)

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

object (CssProductStatus)

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

Attributes

แอตทริบิวต์สำหรับผลิตภัณฑ์ CSS

การแสดง JSON 
{
  "lowPrice": {
    object (Price)
  },
  "highPrice": {
    object (Price)
  },
  "headlineOfferPrice": {
    object (Price)
  },
  "headlineOfferShippingPrice": {
    object (Price)
  },
  "additionalImageLinks": [
    string
  ],
  "productTypes": [
    string
  ],
  "sizeTypes": [
    string
  ],
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productWeight": {
    object (ProductWeight)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productHighlights": [
    string
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "expirationDate": string,
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "headlineOfferInstallment": {
    object (HeadlineOfferInstallment)
  },
  "headlineOfferSubscriptionCost": {
    object (HeadlineOfferSubscriptionCost)
  },
  "cppLink": string,
  "cppMobileLink": string,
  "cppAdsRedirect": string,
  "numberOfOffers": string,
  "headlineOfferCondition": string,
  "headlineOfferLink": string,
  "headlineOfferMobileLink": string,
  "title": string,
  "imageLink": string,
  "description": string,
  "brand": string,
  "mpn": string,
  "gtin": string,
  "googleProductCategory": string,
  "adult": boolean,
  "multipack": string,
  "isBundle": boolean,
  "ageGroup": string,
  "color": string,
  "gender": string,
  "material": string,
  "pattern": string,
  "size": string,
  "sizeSystem": string,
  "itemGroupId": string,
  "pause": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string
}
ช่อง
lowPrice

object (Price)

ราคาต่ำสุดของผลิตภัณฑ์ CSS
highPrice

object (Price)

ราคาสูงสุดของผลิตภัณฑ์ CSS
headlineOfferPrice

object (Price)

ราคาบรรทัดแรกของผลิตภัณฑ์ CSS
headlineOfferShippingPrice

object (Price)

ราคาบรรทัดแรกของผลิตภัณฑ์ CSS
productTypes[]

string

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

string

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

object (ProductDetail)

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

object (ProductWeight)

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

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductDimension)

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

string

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

object (Certification)

รายการใบรับรองที่ CSS อ้างสิทธิ์สำหรับผลิตภัณฑ์หนึ่งๆ
expirationDate

string (Timestamp format)

วันที่ที่รายการควรหมดอายุตามที่ระบุไว้เมื่อแทรกในรูปแบบ ISO 8601 วันที่หมดอายุจริงจะแสดงใน productstatuses เป็น googleExpirationDate และอาจเร็วกว่านั้นหาก expirationDate อยู่ไกลจากปัจจุบันเกินไป หมายเหตุ: ระบบอาจใช้เวลา 2 วันขึ้นไปนับจากวันที่หมดอายุจึงจะลบรายการออก
includedDestinations[]

string

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

string

รายการปลายทางที่จะยกเว้นสําหรับเป้าหมายนี้ (ตรงกับช่องทําเครื่องหมายที่ยังไม่ได้เลือกใน Merchant Center)
headlineOfferInstallment

object (HeadlineOfferInstallment)

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

object (HeadlineOfferSubscriptionCost)

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

string

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

string (int64 format)

จำนวนผลิตภัณฑ์ CSS
headlineOfferCondition

string

เงื่อนไขของข้อเสนอบรรทัดแรก
title

string

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

string

คําอธิบายของสินค้า
brand

string

แอตทริบิวต์ที่เกี่ยวข้องกับผลิตภัณฑ์ [14-36] แบรนด์ของสินค้า
mpn

string

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

string

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

string

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

boolean

ตั้งค่าเป็น "จริง" หากสินค้ามีไว้สำหรับผู้ใหญ่
multipack

string (int64 format)

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

boolean

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

ราคา

ราคาที่แสดงเป็นตัวเลขและสกุลเงิน

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

string (int64 format)

ราคาที่แสดงเป็นตัวเลขเป็นหน่วยไมโคร (1 ล้านหน่วยไมโครเท่ากับ 1 หน่วยมาตรฐานของสกุลเงิน เช่น 1 USD = 1000000 หน่วยไมโคร)
currencyCode

string

สกุลเงินของราคาโดยใช้ตัวย่อ 3 ตัวตาม ISO 4217

ProductDetail

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

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

string

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

string

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

string

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

ProductWeight

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

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

number

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

string

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

ProductDimension

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

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

number

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

string

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

การรับรอง

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

การแสดง JSON 
{
  "name": string,
  "authority": string,
  "code": string
}
ช่อง
name

string

ชื่อของใบรับรอง ปัจจุบันค่าที่ใช้กันมากที่สุดคือ "EPREL" ซึ่งเป็นใบรับรองการประหยัดพลังงานในฐานข้อมูล European Registry for Energy Labeling (EPREL) ของสหภาพยุโรป
authority

string

หน่วยงานหรือหน่วยรับรองที่รับผิดชอบในการออกใบรับรอง ปัจจุบันค่าที่พบบ่อยที่สุดคือ "EC" หรือ "European_Commission" สำหรับฉลากประสิทธิภาพการประหยัดพลังงานในสหภาพยุโรป
code

string

รหัสของใบรับรอง ตัวอย่างเช่น สำหรับใบรับรอง EPREL ที่มีลิงก์ https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456 รหัสคือ 123456 รหัสนี้จำเป็นสำหรับฉลากประสิทธิภาพการประหยัดพลังงานของยุโรป

HeadlineOfferInstallment

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

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

string (int64 format)

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

object (Price)

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

object (Price)

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

HeadlineOfferSubscriptionCost

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 ระบุว่าระยะเวลาการสมัครใช้บริการคือปี

CustomAttribute

ข้อความที่เป็นตัวแทนแอตทริบิวต์ที่กำหนดเอง ต้องระบุ value หรือ groupValues อย่างใดอย่างหนึ่งที่แน่ชัด

การแสดง JSON 
{
  "groupValues": [
    {
      object (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
ช่อง
groupValues[]

object (CustomAttribute)

แอตทริบิวต์ย่อยภายในกลุ่มแอตทริบิวต์นี้ หาก groupValues ไม่ว่างเปล่า value ต้องว่างเปล่า
name

string

ชื่อแอตทริบิวต์
value

string

ค่าของแอตทริบิวต์ หาก value ไม่ว่างเปล่า groupValues ต้องว่างเปล่า

CssProductStatus

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

การแสดง 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 
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
ช่อง
destination

string

ชื่อปลายทาง
approvedCountries[]

string

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

string

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

string

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

ItemLevelIssue

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

การแสดง JSON 
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attribute": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
ช่อง
code

string

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

string

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

string

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

string

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

string

ปลายทางที่มีปัญหา
description

string

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

string

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

string

URL ของหน้าเว็บเพื่อช่วยแก้ปัญหานี้
applicableCountries[]

string

รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่มีปัญหากับผลิตภัณฑ์ CSS

เมธอด

get

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

list

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