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 กำหนดให้กับบัญชี CSS/MC

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

ต้องใช้ขอบเขต 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 แล้ว ระบบอาจใช้เวลาหลายนาทีก่อนที่จะดึงข้อมูลผลิตภัณฑ์ 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 หลังจากแทรก อัปเดต หรือลบข้อมูลผลิตภัณฑ์แล้ว อาจต้องใช้เวลาหลายนาทีก่อนที่จะดึงข้อมูลผลิตภัณฑ์สุดท้ายที่อัปเดตแล้วได้

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

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

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

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

rpc ListCssProducts(ListCssProductsRequest) returns (ListCssProductsResponse)

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

หลังจากแทรก อัปเดต หรือลบข้อมูลผลิตภัณฑ์ CSS แล้ว ระบบอาจใช้เวลาหลายนาทีก่อนที่จะดึงข้อมูลผลิตภัณฑ์ 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 สำหรับบัญชี MCA จะแสดงก็ต่อเมื่อผู้ใช้มีสิทธิ์เข้าถึงบัญชีหลัก หมายเหตุ: สำหรับบัญชีย่อย 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
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 ประเภท (ดูประเภทขนาด)
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
review_count

int64

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

int64

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

int64

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

double

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

การรับรอง

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

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

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

ต้องระบุ รหัสภาษาแบบ 2 ตัวอักษรตามมาตรฐาน ISO 639-1 สำหรับผลิตภัณฑ์ 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 ที่จะดึงข้อมูล รูปแบบ: accounts/{account}/cssProducts/{css_product}

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 ทั้งหมด