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,
  "reviewCount": string,
  "minRating": string,
  "maxRating": string,
  "rating": number
}
ช่อง
lowPrice

object (Price)

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

object (Price)

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

object (Price)

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

object (Price)

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

string

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

string

ทรงของสินค้า โดยสามารถใช้เพื่อแสดงประเภทขนาดที่รวมกันสำหรับสินค้าประเภทเครื่องแต่งกาย ระบุประเภทขนาดได้สูงสุด 2 ประเภท (ดูประเภทขนาด)
productDetails[]

object (ProductDetail)

รายละเอียดทางเทคนิคหรือรายละเอียดสินค้าเพิ่มเติม
productWeight

object (ProductWeight)

น้ำหนักของผลิตภัณฑ์ในหน่วยที่ระบุ ค่าต้องอยู่ระหว่าง 0 (ไม่รวม) ถึง 2,000 (รวม)
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

ค่าที่รองรับมีดังนี้ - css_ads_experiences - css_organic_experiences
excludedDestinations[]

string

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

ค่าที่รองรับมีดังนี้ - css_ads_experiences - css_organic_experiences
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
reviewCount

string (int64 format)

จำนวนรีวิวของผลิตภัณฑ์ ต้องระบุหากระบุ rating ไว้
minRating

string (int64 format)

คะแนนขั้นต่ำของผลิตภัณฑ์ ต้องระบุหากระบุ rating ไว้
maxRating

string (int64 format)

คะแนนสูงสุดของผลิตภัณฑ์ ต้องระบุหากระบุ rating ไว้
rating

number

คะแนนเฉลี่ยของผลิตภัณฑ์ ค่าต้องอยู่ภายในช่วง [minRating, maxRating] (รวม) เมื่อแสดงในหน้าสินค้า คะแนนนี้จะปรับให้เป็นสเกล [1, 5] โดยมีทศนิยม 1 ตำแหน่ง หากระบุ reviewCount คุณต้องระบุ minRating และ maxRating ด้วย

ราคา

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

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

string (int64 format)

ราคาที่แสดงเป็นตัวเลขในหน่วยไมโคร (1 ล้านไมโครเทียบเท่ากับหน่วยมาตรฐานของสกุลเงิน เช่น 1 USD = 1, 000, 000 ไมโคร)
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