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

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

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 (ไม่รวม) ถึง 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

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 = 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