Package google.shopping.css.v1

ดัชนี

AccountLabelsService

จัดการป้ายกำกับบัญชี Merchant Center และ CSS

CreateAccountLabel

rpc CreateAccountLabel(CreateAccountLabelRequest) returns (AccountLabel)

สร้างป้ายกำกับใหม่ที่ไม่ได้กำหนดให้กับบัญชีใดๆ

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

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

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

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

rpc DeleteAccountLabel(DeleteAccountLabelRequest) returns (Empty)

ลบป้ายกำกับและนำออกจากทุกบัญชีที่กำหนดป้ายกำกับไว้

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

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

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

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

rpc ListAccountLabels(ListAccountLabelsRequest) returns (ListAccountLabelsResponse)

แสดงรายการป้ายกำกับที่บัญชีเป็นเจ้าของ

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

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

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

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

rpc UpdateAccountLabel(UpdateAccountLabelRequest) returns (AccountLabel)

อัปเดตป้ายกำกับ

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

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

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

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

AccountsService

บริการสำหรับจัดการข้อมูลบัญชี CSS/MC

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

ดึงข้อมูลบัญชี CSS/MC รายการเดียวตามรหัส

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

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

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

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

rpc ListChildAccounts(ListChildAccountsRequest) returns (ListChildAccountsResponse)

แสดงรายการบัญชีทั้งหมดภายใต้รหัสบัญชี CSS ที่ระบุ และกรองตามรหัสป้ายกำกับและชื่อบัญชี (ไม่บังคับ)

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

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

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

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

rpc UpdateLabels(UpdateAccountLabelsRequest) returns (Account)

อัปเดตป้ายกำกับที่กำหนดให้กับบัญชี CSS/MC ตามโดเมน CSS

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

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

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

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

CssProductInputsService

บริการที่จะใช้ทรัพยากร CssProductInput บริการนี้ช่วยในการแทรก/อัปเดต/ลบผลิตภัณฑ์ CSS

DeleteCssProductInput

rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)

ลบข้อมูลผลิตภัณฑ์ CSS ออกจากบัญชี CSS Center

หลังจากลบแล้ว ระบบอาจใช้เวลาหลายนาทีก่อนที่อินพุตจะใช้งานไม่ได้อีกต่อไป

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

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

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

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

rpc InsertCssProductInput(InsertCssProductInputRequest) returns (CssProductInput)

อัปโหลด CssProductInput ไปยังบัญชี CSS Center หากมีอินพุตที่มี contentLanguage, identity, feedLabel และ feedId เดียวกันอยู่แล้ว วิธีการนี้จะแทนที่รายการนั้น

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

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

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

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

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

rpc UpdateCssProductInput(UpdateCssProductInputRequest) returns (CssProductInput)

อัปเดตอินพุตผลิตภัณฑ์ CSS ที่มีอยู่ในบัญชี CSS Center

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

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

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

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

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

CssProductsService

บริการสำหรับรับและแสดงรายการในผลิตภัณฑ์ CSS(หรือที่เรียกว่าข้อเสนอแบบรวมภายใน)

GetCssProduct

rpc GetCssProduct(GetCssProductRequest) returns (CssProduct)

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

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

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

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

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

rpc ListCssProducts(ListCssProductsRequest) returns (ListCssProductsResponse)

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

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

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

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

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

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

QuotaService

บริการสำหรับรับข้อมูลโควต้าการเรียกเมธอดต่อเมธอด CSS API

ListQuotaGroups

rpc ListQuotaGroups(ListQuotaGroupsRequest) returns (ListQuotaGroupsResponse)

แสดงโควต้าการโทรและการใช้งานรายวันต่อกลุ่มสำหรับบัญชี CSS Center

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

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

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

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

บัญชี

ข้อมูลเกี่ยวกับบัญชี CSS/MC

ช่อง
name

string

ชื่อทรัพยากรของป้ายกำกับ รูปแบบ: accounts/{account}
full_name

string

เอาต์พุตเท่านั้น เปลี่ยนแปลงไม่ได้ ชื่อและนามสกุลของบัญชี CSS/MC
label_ids[]

int64

รหัสป้ายกำกับที่บัญชีหลักของ CSS กำหนดให้กับบัญชี CSS/MC ด้วยตนเอง
automatic_label_ids[]

int64

รหัสป้ายกำกับที่สร้างโดยอัตโนมัติซึ่ง CSS Center กำหนดให้กับบัญชี MC
account_type

AccountType

เอาต์พุตเท่านั้น ประเภทของบัญชีนี้
display_name

string

ชื่อที่แสดงแบบย่อของบัญชี CSS/MC
homepage_uri

string

เอาต์พุตเท่านั้น เปลี่ยนแปลงไม่ได้ หน้าแรกของบัญชี CSS/MC
parent

string

ทรัพยากรหลักของบัญชี CSS/MC กลุ่ม CSS สำหรับโดเมน CSS และโดเมน CSS สำหรับบัญชี MC ระบบจะแสดงผลเฉพาะในกรณีที่ผู้ใช้มีสิทธิ์เข้าถึงบัญชีหลัก หมายเหตุ: สำหรับบัญชีย่อย MC โดเมนนี้จะเป็นโดเมน CSS ซึ่งเป็นทรัพยากรหลักของบัญชี MCA ด้วย เนื่องจากเรากำลังทำให้ลําดับชั้นเรียบง่ายขึ้น"

AccountType

ประเภทบัญชี

Enum
ACCOUNT_TYPE_UNSPECIFIED ประเภทบัญชีที่ไม่รู้จัก
CSS_GROUP บัญชีกลุ่ม CSS
CSS_DOMAIN บัญชีโดเมน CSS
MC_PRIMARY_CSS_MCA บัญชี MCA หลักของ CSS ของ MC
MC_CSS_MCA บัญชี MCA ของ MC CSS
MC_MARKETPLACE_MCA บัญชี MCA ของ MC Marketplace
MC_OTHER_MCA บัญชี MCA อื่นๆ ของ MC
MC_STANDALONE บัญชี MC แบบสแตนด์อโลน
MC_MCA_SUBACCOUNT บัญชีย่อย MCA ของ MC

AccountLabel

ป้ายกำกับที่โดเมน CSS หรือกลุ่ม CSS กำหนดให้กับบัญชีย่อยบัญชีใดบัญชีหนึ่ง

ช่อง
name

string

ตัวระบุ ชื่อทรัพยากรของป้ายกำกับ รูปแบบ: accounts/{account}/labels/{label}
label_id

int64

เอาต์พุตเท่านั้น รหัสของป้ายกำกับ
account_id

int64

เอาต์พุตเท่านั้น รหัสของบัญชีที่ป้ายกำกับนี้อยู่
label_type

LabelType

เอาต์พุตเท่านั้น ประเภทของป้ายกำกับนี้
display_name

string

ชื่อที่แสดงของป้ายกำกับนี้
description

string

คำอธิบายของป้ายกำกับนี้

LabelType

ประเภทป้ายกำกับ

Enum
LABEL_TYPE_UNSPECIFIED ประเภทป้ายกำกับที่ไม่รู้จัก
MANUAL ระบุว่าสร้างป้ายกำกับด้วยตนเอง
AUTOMATIC บ่งบอกว่า CSS Center สร้างขึ้นโดยอัตโนมัติ

Attributes

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

ช่อง
low_price

Price

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

Price

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

Price

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

Price

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

string

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

string

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

ProductDetail

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

ProductWeight

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

ProductDimension

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

ProductDimension

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

ProductDimension

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

string

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

Certification

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

Timestamp

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

string

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

string

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

HeadlineOfferInstallment

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

HeadlineOfferSubscriptionCost

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

string

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

int64

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

bool

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

int64

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

bool

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

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

การรับรอง

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

ช่อง
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 รหัสนี้จำเป็นสำหรับฉลากประสิทธิภาพการประหยัดพลังงานของยุโรป

CreateAccountLabelRequest

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

ช่อง
parent

string

ต้องระบุ บัญชีหลัก รูปแบบ: accounts/{account}
account_label

AccountLabel

ต้องระบุ ป้ายกำกับที่จะสร้าง

CssProduct

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

ช่อง
name

string

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

string

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

string

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

string

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

Attributes

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

CustomAttribute

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

CssProductStatus

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

CssProductInput

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

ช่อง
name

string

ตัวระบุ ชื่อของอินพุตผลิตภัณฑ์ CSS รูปแบบ: accounts/{account}/cssProductInputs/{css_product_input} โดยที่ส่วนสุดท้าย css_product_input ประกอบด้วย 3 ส่วน ได้แก่ contentLanguage~feedLabel~offerId ตัวอย่าง: accounts/123/cssProductInputs/de~DE~rawProvidedId123
final_name

string

เอาต์พุตเท่านั้น ชื่อของผลิตภัณฑ์ CSS ที่ประมวลผลแล้ว รูปแบบ: accounts/{account}/cssProducts/{css_product} "
raw_provided_id

string

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

string

ต้องระบุ รหัสภาษา ISO 639-1 แบบ 2 ตัวอักษรสำหรับผลิตภัณฑ์ CSS
feed_label

string

ต้องระบุ ป้ายกำกับฟีดสำหรับผลิตภัณฑ์ CSS ป้ายกํากับฟีดมีความหมายเหมือนกับ "ประเทศเป้าหมาย" จึงควรเป็นรหัสภูมิภาคที่ถูกต้องเสมอ เช่น 'DE' สำหรับเยอรมนี 'FR' สำหรับฝรั่งเศส
freshness_time
(deprecated)

Timestamp

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

ช่องนี้ต้องไม่เป็นเวลาในอนาคต

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

หากไม่ได้ตั้งค่า ระบบจะไม่ป้องกันไม่ให้อัปเดต และเวลาอัปเดตล่าสุดจะเป็นค่าเริ่มต้นเมื่อ CSS API ได้รับคำขอนี้

หากมีการป้องกันการดําเนินการ ระบบจะแสดงข้อยกเว้นที่ยกเลิก
attributes

Attributes

รายการแอตทริบิวต์ผลิตภัณฑ์ CSS
custom_attributes[]

CustomAttribute

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

CssProductStatus

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

ช่อง
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

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

ช่อง
destination

string

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

string

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

string

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

string

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

ItemLevelIssue

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

ช่อง
code

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

DeleteAccountLabelRequest

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

ช่อง
name

string

ต้องระบุ ชื่อของป้ายกำกับที่จะลบ รูปแบบ: accounts/{account}/labels/{label}

DeleteCssProductInputRequest

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

ช่อง
name

string

ต้องระบุ ชื่อของแหล่งข้อมูลอินพุตผลิตภัณฑ์ CSS ที่จะลบ รูปแบบ: accounts/{account}/cssProductInputs/{css_product_input} โดยที่ส่วนสุดท้าย css_product_input ประกอบด้วย 3 ส่วน ได้แก่ contentLanguage~feedLabel~offerId ตัวอย่าง: accounts/123/cssProductInputs/de~DE~rawProvidedId123
supplemental_feed_id

int64

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

GetAccountRequest

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

ช่อง
name

string

ต้องระบุ ชื่อบัญชี CSS/MC ที่มีการจัดการ รูปแบบ: accounts/{account}
parent

string

ไม่บังคับ จำเป็นต้องใช้เฉพาะเมื่อดึงข้อมูลบัญชี MC เท่านั้น โดเมน CSS ที่เป็นทรัพยากรหลักของบัญชี MC รูปแบบ: accounts/{account}

GetCssProductRequest

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

ช่อง
name

string

ต้องระบุ ชื่อผลิตภัณฑ์ CSS ที่จะดึงข้อมูล

HeadlineOfferInstallment

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

ช่อง
months

int64

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

Price

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

Price

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

HeadlineOfferSubscriptionCost

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

ช่อง
period

SubscriptionPeriod

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

int64

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

Price

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

InsertCssProductInputRequest

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

ช่อง
parent

string

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

CssProductInput

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

int64

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

ListAccountLabelsRequest

คำขอข้อความสำหรับเมธอด ListAccountLabels

ช่อง
parent

string

ต้องระบุ บัญชีหลัก รูปแบบ: accounts/{account}
page_size

int32

จำนวนสูงสุดของป้ายกำกับที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผลป้ายกำกับสูงสุด 50 รายการ ค่าสูงสุดคือ 1,000 ระบบจะบังคับให้ค่าที่มากกว่า 1,000 เป็น 1,000
page_token

string

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

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

ListAccountLabelsResponse

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

ช่อง
account_labels[]

AccountLabel

ป้ายกำกับจากบัญชีที่ระบุ
next_page_token

string

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

ListChildAccountsRequest

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

ช่อง
parent

string

ต้องระบุ บัญชีหลัก ต้องเป็นกลุ่มหรือโดเมน CSS รูปแบบ: accounts/{account}
page_size

int32

ไม่บังคับ จำนวนบัญชีสูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผลบัญชีสูงสุด 50 บัญชี ค่าสูงสุดคือ 100 ค่าที่มากกว่า 100 จะเปลี่ยนเป็น 100
page_token

string

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

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

int64

หากตั้งค่าไว้ ระบบจะแสดงเฉพาะบัญชี MC ที่มีรหัสป้ายกำกับที่ระบุเท่านั้น
full_name

string

หากตั้งค่าไว้ ระบบจะแสดงเฉพาะบัญชี MC ที่มีชื่อที่ระบุ (คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่)

ListChildAccountsResponse

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

ช่อง
accounts[]

Account

บัญชี CSS/MC ที่แสดงผลสําหรับบัญชีหลัก CSS ที่ระบุ
next_page_token

string

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

ListCssProductsRequest

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

ช่อง
parent

string

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

int32

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

string

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

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

ListCssProductsResponse

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

ช่อง
css_products[]

CssProduct

ผลิตภัณฑ์ CSS ที่ประมวลผลแล้วจากบัญชีที่ระบุ ผลิตภัณฑ์ CSS ที่ประมวลผลแล้วหลังจากใช้กฎและฟีดเสริม
next_page_token

string

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

ListQuotaGroupsRequest

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

ช่อง
parent

string

ต้องระบุ บัญชี CSS ที่เป็นเจ้าของคอลเล็กชันโควต้าและทรัพยากรของเมธอด ในกรณีส่วนใหญ่ โดเมนนี้คือโดเมน CSS รูปแบบ: accounts/{account}
page_size

int32

ไม่บังคับ จำนวนโควต้าสูงสุดที่จะแสดงในการตอบกลับ ซึ่งใช้สําหรับการแบ่งหน้า ค่าเริ่มต้นคือ 500 ค่าที่มากกว่า 1,000 จะเปลี่ยนเป็น 1,000
page_token

string

ไม่บังคับ โทเค็น (หากมี) เพื่อดึงข้อมูลหน้าถัดไป พารามิเตอร์อื่นๆ ทั้งหมดต้องตรงกับการเรียกครั้งแรกที่ให้โทเค็นหน้าเว็บ

ListQuotaGroupsResponse

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

ช่อง
quota_groups[]

QuotaGroup

วิธีการ การใช้โควต้าปัจจุบัน และขีดจํากัดของแต่ละกลุ่ม โควต้าจะแชร์กันระหว่างวิธีการทั้งหมดในกลุ่ม ระบบจะจัดเรียงกลุ่มจากมากไปน้อยตาม quota_usage
next_page_token

string

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

MethodDetails

รายละเอียดเมธอดต่อเมธอดใน CSS API

ช่อง
method

string

เอาต์พุตเท่านั้น ชื่อของเมธอด เช่น cssproductsservice.listcssproducts
version

string

เอาต์พุตเท่านั้น เวอร์ชัน API ของเมธอด
subapi

string

เอาต์พุตเท่านั้น API ย่อยที่เมธอดนั้นอยู่ ใน CSS API ค่านี้จะเท่ากับ css เสมอ
path

string

เอาต์พุตเท่านั้น เส้นทางสำหรับเมธอด เช่น v1/cssproductsservice.listcssproducts

ProductDetail

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

ช่อง
section_name

string

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

string

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

string

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

ProductDimension

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

ช่อง
value

double

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

string

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

ProductWeight

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

ช่อง
value

double

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

string

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

QuotaGroup

ข้อมูลกลุ่มสำหรับเมธอดใน CSS API โควต้าจะแชร์กันระหว่างวิธีการทั้งหมดในกลุ่ม แม้ว่าจะไม่มีวิธีการใดภายในกลุ่มที่มีการใช้งาน ระบบก็จะแสดงข้อมูลของกลุ่ม

ช่อง
name

string

ตัวระบุ ชื่อแหล่งข้อมูลของกลุ่มโควต้า รูปแบบ: accounts/{account}/quotas/{group} ตัวอย่างเช่น accounts/12345678/quotas/css-products-insert หมายเหตุ: ส่วน {group} ไม่ได้รับประกันว่าจะเป็นไปตามรูปแบบที่เจาะจง
quota_usage

int64

เอาต์พุตเท่านั้น การใช้งานโควต้าปัจจุบัน ซึ่งหมายถึงจํานวนการเรียกใช้เมธอดในกลุ่มในวันหนึ่งๆ ขีดจำกัดโควต้ารายวันจะรีเซ็ตตอนเที่ยงวันเวลา 12:00 น. (UTC)
quota_limit

int64

เอาต์พุตเท่านั้น จำนวนการโทรสูงสุดที่อนุญาตต่อวันสำหรับกลุ่ม
quota_minute_limit

int64

เอาต์พุตเท่านั้น จำนวนการโทรสูงสุดที่อนุญาตต่อนาทีสำหรับกลุ่ม
method_details[]

MethodDetails

เอาต์พุตเท่านั้น รายการวิธีการทั้งหมดที่โควต้ากลุ่มมีผล

SubscriptionPeriod

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

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

UpdateAccountLabelRequest

คำขอข้อความสำหรับเมธอด UpdateAccountLabel

ช่อง
account_label

AccountLabel

ต้องระบุ ป้ายกำกับที่อัปเดตแล้ว ต้องกรอกข้อมูลในช่องทั้งหมด

UpdateAccountLabelsRequest

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

ช่อง
name

string

ต้องระบุ ชื่อทรัพยากรของป้ายกำกับ รูปแบบ: accounts/{account}
label_ids[]

int64

รายการรหัสป้ายกำกับที่จะเขียนทับรหัสป้ายกำกับบัญชีที่มีอยู่ หากรายการว่างเปล่า ระบบจะลบรหัสป้ายกำกับที่กำหนดไว้ทั้งหมดในปัจจุบัน
parent

string

ไม่บังคับ จำเป็นต้องระบุเฉพาะเมื่ออัปเดตป้ายกำกับบัญชี MC โดเมน CSS ที่เป็นทรัพยากรหลักของบัญชี MC รูปแบบ: accounts/{account}

UpdateCssProductInputRequest

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

ช่อง
css_product_input

CssProductInput

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

FieldMask

รายการแอตทริบิวต์ผลิตภัณฑ์ CSS ที่จะอัปเดต

หากไม่ระบุมาสก์การอัปเดต ระบบจะถือว่ามาสก์ช่องโดยนัยนั้นเทียบเท่ากับช่องทั้งหมดที่ป้อนข้อมูล (มีค่าที่ไม่ใช่ค่าว่าง)

ระบบจะลบแอตทริบิวต์ที่ระบุในมาสก์การอัปเดตซึ่งไม่มีค่าที่ระบุไว้ในเนื้อหาออกจากผลิตภัณฑ์ CSS

คุณจะระบุมาสก์การอัปเดตได้เฉพาะสำหรับฟิลด์ระดับบนสุดในแอตทริบิวต์และแอตทริบิวต์ที่กำหนดเองเท่านั้น

หากต้องการระบุมาสก์การอัปเดตสำหรับแอตทริบิวต์ที่กำหนดเอง คุณต้องเพิ่มคำนำหน้า custom_attribute.

ระบบไม่รองรับการให้ค่า "*" พิเศษสำหรับการแทนที่ผลิตภัณฑ์ CSS แบบเต็ม