Package google.shopping.css.v1

Chỉ mục

AccountLabelsService

Quản lý nhãn tài khoản Merchant Center và CSS.

CreateAccountLabel

rpc CreateAccountLabel(CreateAccountLabelRequest) returns (AccountLabel)

Tạo nhãn mới, không được chỉ định cho bất kỳ tài khoản nào.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
DeleteAccountLabel

rpc DeleteAccountLabel(DeleteAccountLabelRequest) returns (Empty)

Xoá một nhãn và xoá nhãn đó khỏi tất cả tài khoản được chỉ định.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
ListAccountLabels

rpc ListAccountLabels(ListAccountLabelsRequest) returns (ListAccountLabelsResponse)

Liệt kê các nhãn thuộc sở hữu của một tài khoản.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
UpdateAccountLabel

rpc UpdateAccountLabel(UpdateAccountLabelRequest) returns (AccountLabel)

Cập nhật nhãn.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

AccountsService

Dịch vụ quản lý thông tin tài khoản CSS/MC.

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Truy xuất một tài khoản CSS/MC theo mã nhận dạng.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
ListChildAccounts

rpc ListChildAccounts(ListChildAccountsRequest) returns (ListChildAccountsResponse)

Liệt kê tất cả tài khoản theo mã tài khoản CSS đã chỉ định và có thể lọc theo mã nhãn và tên tài khoản.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
UpdateLabels

rpc UpdateLabels(UpdateAccountLabelsRequest) returns (Account)

Cập nhật nhãn được miền CSS chỉ định cho tài khoản CSS/MC.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

CssProductInputsService

Dịch vụ sử dụng tài nguyên CssProductInput. Dịch vụ này giúp chèn/cập nhật/xoá Sản phẩm CSS.

DeleteCssProductInput

rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)

Xoá một đầu vào Sản phẩm CSS khỏi tài khoản CSS Center.

Sau khi bạn xoá, có thể mất vài phút thì đầu vào mới không còn nữa.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
InsertCssProductInput

rpc InsertCssProductInput(InsertCssProductInputRequest) returns (CssProductInput)

Tải một CssProductInput lên tài khoản CSS Center của bạn. Nếu đã có một đầu vào có cùng contentLanguage, identity, feedLabel và feedId, thì phương thức này sẽ thay thế mục đó.

Sau khi bạn chèn, cập nhật hoặc xoá một CSS Product input, có thể mất vài phút thì bạn mới có thể truy xuất CSS Product đã xử lý.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
UpdateCssProductInput

rpc UpdateCssProductInput(UpdateCssProductInputRequest) returns (CssProductInput)

Cập nhật thông tin đầu vào Css Product hiện có trong tài khoản CSS Center.

Sau khi chèn, cập nhật hoặc xoá một CSS Product input, có thể mất vài phút thì bạn mới có thể truy xuất Css Product đã xử lý.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

CssProductsService

Dịch vụ để thực hiện thao tác get và list trên Sản phẩm CSS(còn gọi là Sản phẩm tổng hợp nội bộ).

GetCssProduct

rpc GetCssProduct(GetCssProductRequest) returns (CssProduct)

Truy xuất sản phẩm CSS đã xử lý từ tài khoản CSS Center. Sau khi bạn chèn, cập nhật hoặc xoá một dữ liệu đầu vào sản phẩm, có thể mất vài phút thì sản phẩm cuối cùng đã cập nhật mới có thể truy xuất được.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
ListCssProducts

rpc ListCssProducts(ListCssProductsRequest) returns (ListCssProductsResponse)

Liệt kê các sản phẩm CSS đã được xử lý trong tài khoản CSS Center. Phản hồi có thể chứa ít mục hơn so với số lượng được chỉ định theo pageSize. Dựa vào pageToken để xác định xem có cần yêu cầu thêm mục nào không.

Sau khi bạn chèn, cập nhật hoặc xoá một đầu vào sản phẩm CSS, có thể mất vài phút thì bạn mới có thể truy xuất sản phẩm CSS đã xử lý được cập nhật.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

QuotaService

Dịch vụ để nhận thông tin về hạn mức lệnh gọi phương thức cho mỗi phương thức CSS API.

ListQuotaGroups

rpc ListQuotaGroups(ListQuotaGroupsRequest) returns (ListQuotaGroupsResponse)

Liệt kê hạn mức và mức sử dụng lệnh gọi hằng ngày cho mỗi nhóm trong tài khoản CSS Center.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

Tài khoản

Thông tin về tài khoản CSS/tài khoản nhiều khách hàng.

Trường
name

string

Tên tài nguyên nhãn. Định dạng: accounts/{account}
full_name

string

Chỉ có đầu ra. Không thể thay đổi. Họ tên đầy đủ của tài khoản CSS/MC.
label_ids[]

int64

Mã nhãn do tài khoản mẹ CSS chỉ định cho tài khoản CSS/tài khoản nhiều khách hàng được tạo theo cách thủ công.
automatic_label_ids[]

int64

Mã nhận dạng nhãn do CSS Center tự động tạo và chỉ định cho tài khoản MC.
account_type

AccountType

Chỉ có đầu ra. Loại tài khoản này.
display_name

string

Tên hiển thị ngắn của tài khoản CSS/MC.
homepage_uri

string

Chỉ có đầu ra. Không thể thay đổi. Trang chủ của tài khoản CSS/MC.
parent

string

Tài nguyên mẹ của tài khoản CSS/MC. Nhóm Dịch vụ so sánh giá cho miền CSS; miền CSS cho tài khoản nhiều khách hàng. Chỉ trả về nếu người dùng có quyền truy cập vào tài khoản chính. Lưu ý: Đối với tài khoản phụ nhiều khách hàng, đây cũng là miền CSS là tài nguyên mẹ của tài khoản MCA, vì chúng tôi đang đơn giản hoá hệ thống phân cấp một cách hiệu quả."

AccountType

Loại tài khoản.

Enum
ACCOUNT_TYPE_UNSPECIFIED Loại tài khoản không xác định.
CSS_GROUP Tài khoản nhóm Dịch vụ so sánh giá.
CSS_DOMAIN Tài khoản miền CSS.
MC_PRIMARY_CSS_MCA Tài khoản MCA CSS chính của MC.
MC_CSS_MCA Tài khoản nhiều khách hàng (MCA) CSS của tài khoản người bán.
MC_MARKETPLACE_MCA Tài khoản MCA của trang web thương mại MC.
MC_OTHER_MCA MC Tài khoản MCA khác.
MC_STANDALONE Tài khoản độc lập MC.
MC_MCA_SUBACCOUNT Tài khoản phụ MCA của MC.

AccountLabel

Nhãn do miền CSS hoặc nhóm Dịch vụ so sánh giá chỉ định cho một trong các tài khoản phụ của miền hoặc nhóm đó.

Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của nhãn. Định dạng: accounts/{account}/labels/{label}
label_id

int64

Chỉ có đầu ra. Mã của nhãn.
account_id

int64

Chỉ có đầu ra. Mã của tài khoản mà nhãn này thuộc về.
label_type

LabelType

Chỉ có đầu ra. Loại nhãn này.
display_name

string

Tên hiển thị của nhãn này.
description

string

Nội dung mô tả về nhãn này.

LabelType

Loại nhãn.

Enum
LABEL_TYPE_UNSPECIFIED Loại nhãn không xác định.
MANUAL Cho biết nhãn được tạo theo cách thủ công.
AUTOMATIC Cho biết rằng nhãn này được CSS Center tạo tự động.

Thuộc tính

Thuộc tính cho sản phẩm CSS.

Trường
low_price

Price

Giá thấp của sản phẩm CSS.
high_price

Price

Giá cao của sản phẩm CSS.
headline_offer_price

Price

Giá trên tiêu đề của sản phẩm CSS.
headline_offer_shipping_price

Price

Giá trên tiêu đề của sản phẩm CSS.
product_types[]

string

Danh mục của mặt hàng (được định dạng như trong quy cách dữ liệu sản phẩm).
size_types[]

string

Kiểu cắt của mặt hàng. Bạn có thể dùng thuộc tính này để biểu thị các loại kích thước kết hợp cho mặt hàng quần áo. Bạn có thể cung cấp tối đa 2 loại kích thước (xem loại kích thước).
product_details[]

ProductDetail

Thông số kỹ thuật hoặc chi tiết sản phẩm bổ sung.
product_weight

ProductWeight

Trọng lượng của sản phẩm theo đơn vị được cung cấp. Giá trị phải nằm trong khoảng từ 0 (không bao gồm) đến 2000 (bao gồm).
product_length

ProductDimension

Chiều dài của sản phẩm theo đơn vị được cung cấp. Giá trị phải nằm trong khoảng từ 0 (không bao gồm) đến 3000 (bao gồm).
product_width

ProductDimension

Chiều rộng của sản phẩm theo đơn vị được cung cấp. Giá trị phải nằm trong khoảng từ 0 (không bao gồm) đến 3000 (bao gồm).
product_height

ProductDimension

Chiều cao của sản phẩm theo đơn vị được cung cấp. Giá trị phải nằm trong khoảng từ 0 (không bao gồm) đến 3000 (bao gồm).
product_highlights[]

string

Các gạch đầu dòng mô tả những điểm nổi bật phù hợp nhất của một sản phẩm.
certifications[]

Certification

Danh sách các chứng nhận mà CSS đã xác nhận quyền sở hữu cho sản phẩm nhất định.
expiration_date

Timestamp

Ngày hết hạn của mặt hàng (được chỉ định khi chèn) ở định dạng ISO 8601. Ngày hết hạn thực tế được hiển thị trong productstatuses dưới dạng googleExpirationDate và có thể sớm hơn nếu expirationDate quá xa trong tương lai. Lưu ý: Có thể mất từ 2 ngày trở lên kể từ ngày hết hạn để mặt hàng thực sự bị xoá.
included_destinations[]

string

Danh sách các vị trí cần thêm vào mục tiêu này (tương ứng với hộp kiểm được đánh dấu trong Merchant Center). Các vị trí mặc định luôn được đưa vào trừ phi vị trí đó được cung cấp trong excludedDestinations.
excluded_destinations[]

string

Danh sách các vị trí cần loại trừ khỏi mục tiêu này (tương ứng với hộp kiểm không được đánh dấu trong Merchant Center).
headline_offer_installment

HeadlineOfferInstallment

Số lần và số tiền trả góp để thanh toán cho một mặt hàng.
headline_offer_subscription_cost

HeadlineOfferSubscriptionCost

Số kỳ hạn (tháng hoặc năm) và số tiền thanh toán cho mỗi kỳ hạn của một mặt hàng có hợp đồng thuê bao liên kết.
cpp_ads_redirect

string

Cho phép nhà quảng cáo ghi đè URL mặt hàng khi sản phẩm xuất hiện trong bối cảnh của quảng cáo sản phẩm.
number_of_offers

int64

Số lượng sản phẩm CSS.
headline_offer_condition

string

Tình trạng của ưu đãi trên tiêu đề.
title

string

Tiêu đề của mặt hàng.
description

string

Nội dung mô tả về mặt hàng.
brand

string

Thuộc tính liên quan đến sản phẩm.[14-36] Thương hiệu của mặt hàng.
mpn

string

Mã số linh kiện của nhà sản xuất (MPN) của mặt hàng.
gtin

string

Mã số sản phẩm thương mại toàn cầu (GTIN) của mặt hàng.
google_product_category

string

Danh mục của Google đối với mặt hàng (xem cây phân loại sản phẩm của Google). Khi truy vấn sản phẩm, trường này sẽ chứa giá trị do người dùng cung cấp. Hiện tại, không có cách nào để lấy lại danh mục sản phẩm được Google tự động chỉ định thông qua API.
adult

bool

Đặt thành true nếu mặt hàng đó nhắm đến người lớn.
multipack

int64

Số lượng sản phẩm giống nhau trong một lô sản phẩm do người bán xác định.
is_bundle

bool

Mặt hàng có phải là gói do người bán xác định hay không. Gói là một nhóm tuỳ chỉnh gồm nhiều sản phẩm do người bán bán với một mức giá duy nhất.
age_group

string

Nhóm tuổi mục tiêu của mặt hàng.
color

string

Màu sắc của mặt hàng.
gender

string

Giới tính mục tiêu của mặt hàng.
material

string

Chất liệu tạo nên mặt hàng.
pattern

string

Hoa văn của mặt hàng (ví dụ: chấm bi).
size

string

Kích thước của mặt hàng. Bạn chỉ được thêm một giá trị. Đối với các biến thể có nhiều kích thước, hãy chèn một sản phẩm riêng cho từng kích thước có cùng giá trị itemGroupId (xem phần định nghĩa về kích thước [https://support.google.com/merchants/answer/6324492]).
size_system

string

Hệ thống mà kích thước được chỉ định. Nên dùng cho các mặt hàng may mặc.
item_group_id

string

Giá trị nhận dạng dùng chung cho tất cả các biến thể của cùng một sản phẩm.
pause

string

Việc xuất bản mục này sẽ tạm thời bị tạm dừng.
custom_label_0

string

Nhãn tuỳ chỉnh 0 để nhóm tuỳ chỉnh các mặt hàng trong chiến dịch Mua sắm.
custom_label_1

string

Nhãn tuỳ chỉnh 1 để nhóm tuỳ chỉnh các mặt hàng trong một chiến dịch Mua sắm.
custom_label_2

string

Nhãn tuỳ chỉnh 2 để nhóm tuỳ chỉnh các mặt hàng trong một chiến dịch Mua sắm.
custom_label_3

string

Nhãn tuỳ chỉnh 3 để nhóm tuỳ chỉnh các mặt hàng trong một chiến dịch Mua sắm.
custom_label_4

string

Nhãn tuỳ chỉnh 4 để nhóm tuỳ chỉnh các mặt hàng trong một chiến dịch Mua sắm.
review_count

int64

Số lượng bài đánh giá về sản phẩm. Bắt buộc nếu bạn cung cấp rating. Trường này dành cho một tính năng sắp ra mắt và hiện chưa được sử dụng.
min_rating

int64

Điểm xếp hạng tối thiểu của sản phẩm. Bắt buộc nếu bạn cung cấp rating. Trường này dành cho một tính năng sắp ra mắt và hiện chưa được sử dụng.
max_rating

int64

Điểm xếp hạng tối đa của sản phẩm. Bắt buộc nếu bạn cung cấp rating. Trường này dành cho một tính năng sắp ra mắt và hiện chưa được sử dụng.
rating

double

Điểm xếp hạng trung bình của sản phẩm. Giá trị phải nằm trong phạm vi [min_rating, max_rating], kể cả hai giá trị này. Khi xuất hiện trên trang sản phẩm, điểm xếp hạng này được chuẩn hoá theo thang điểm [1, 5] với một chữ số thập phân. Nếu được cung cấp, bạn cũng phải có review_count, min_rating và max_rating. Trường này dành cho một tính năng sắp ra mắt và hiện chưa được sử dụng.

Giấy chứng nhận

Chứng nhận của sản phẩm. Sử dụng thuộc tính này để mô tả các chứng nhận, chẳng hạn như điểm xếp hạng hiệu suất năng lượng, có liên kết với một sản phẩm.

Trường
name

string

Tên chứng nhận. Hiện tại, giá trị phổ biến nhất là "EPREL". Giá trị này thể hiện chứng nhận về hiệu quả về năng lượng trong cơ sở dữ liệu Cơ quan đăng ký nhãn năng lượng Châu Âu (EPREL) của Liên minh Châu Âu.
authority

string

Cơ quan hoặc tổ chức cấp chứng nhận chịu trách nhiệm về việc cấp chứng nhận. Hiện tại, giá trị phổ biến nhất là "EC" hoặc "European_Commission" cho nhãn năng lượng ở Liên minh Châu Âu.
code

string

Mã chứng nhận. Ví dụ: Đối với chứng nhận EPREL có đường liên kết https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456, mã chứng nhận là 123456. Đây là mã bắt buộc đối với nhãn năng lượng Châu Âu.

CreateAccountLabelRequest

Thông báo yêu cầu cho phương thức "CreateAccountLabel".

Trường
parent

string

Bắt buộc. Tài khoản mẹ. Định dạng: accounts/{account}
account_label

AccountLabel

Bắt buộc. Nhãn cần tạo.

CssProduct

Sản phẩm CSS đã được xử lý.

Trường
name

string

Tên của sản phẩm CSS. Định dạng "accounts/{account}/cssProducts/{css_product}"
raw_provided_id

string

Chỉ có đầu ra. Giá trị nhận dạng thô riêng biệt của sản phẩm.
content_language

string

Chỉ có đầu ra. Mã ngôn ngữ gồm 2 chữ cái theo tiêu chuẩn ISO 639-1 cho sản phẩm.
feed_label

string

Chỉ có đầu ra. Nhãn nguồn cấp dữ liệu của sản phẩm.
attributes

Attributes

Chỉ có đầu ra. Danh sách các thuộc tính sản phẩm.
custom_attributes[]

CustomAttribute

Chỉ có đầu ra. Danh sách các thuộc tính tuỳ chỉnh (do CSS cung cấp). Bạn cũng có thể dùng thuộc tính này để gửi mọi thuộc tính của quy cách nguồn cấp dữ liệu ở dạng chung (ví dụ: { "name": "size type", "value": "regular" }). Điều này rất hữu ích khi gửi những thuộc tính mà API không công khai một cách rõ ràng, chẳng hạn như các thuộc tính bổ sung được dùng cho chương trình Mua trên Google.
css_product_status

CssProductStatus

Chỉ có đầu ra. Trạng thái của một sản phẩm, các vấn đề về xác thực dữ liệu, tức là thông tin về một sản phẩm được tính toán không đồng bộ.

CssProductInput

Tài nguyên này đại diện cho dữ liệu đầu vào mà bạn gửi cho một Sản phẩm CSS, chứ không phải Sản phẩm CSS đã xử lý mà bạn thấy trong CSS Center, trong Quảng cáo Mua sắm hoặc trên các nền tảng của Google.

Trường
name

string

Giá trị nhận dạng. Tên của đầu vào Sản phẩm CSS. Định dạng: accounts/{account}/cssProductInputs/{css_product_input}, trong đó phần cuối cùng css_product_input bao gồm 3 phần: contentLanguage~feedLabel~offerId. Ví dụ: accounts/123/cssProductInputs/de~DE~rawProvidedId123
final_name

string

Chỉ có đầu ra. Tên của sản phẩm CSS đã được xử lý. Định dạng: accounts/{account}/cssProducts/{css_product} "
raw_provided_id

string

Bắt buộc. Giá trị nhận dạng riêng biệt của bạn cho Sản phẩm CSS. Điều này cũng tương tự đối với CSS Product input và CSS Product đã xử lý. Chúng tôi chỉ cho phép mã nhận dạng chứa ký tự chữ và số, dấu gạch dưới và dấu gạch ngang. Hãy xem quy cách nguồn cấp dữ liệu sản phẩm để biết thông tin chi tiết.
content_language

string

Bắt buộc. Mã ngôn ngữ gồm 2 chữ cái theo tiêu chuẩn ISO 639-1 cho Sản phẩm CSS.
feed_label

string

Bắt buộc. Nhãn nguồn cấp dữ liệu cho sản phẩm CSS. Nhãn nguồn cấp dữ liệu đồng nghĩa với "quốc gia mục tiêu" và do đó, nhãn này phải luôn là mã khu vực hợp lệ. Ví dụ: "DE" cho Đức, "FR" cho Pháp.
freshness_time
(deprecated)

Timestamp

KHÔNG CÒN DÙNG NỮA. Thay vào đó, hãy sử dụng expiration_date. Đại diện cho phiên bản hiện tại (mức độ mới) của Sản phẩm CSS. Bạn có thể dùng phiên bản này để duy trì đúng thứ tự khi thực hiện nhiều nội dung cập nhật cùng lúc.

Bạn không được đặt trường này thành thời gian trong tương lai.

Nếu được đặt, bản cập nhật sẽ không được thực hiện nếu hệ thống của chúng tôi đã có phiên bản mới hơn của mặt hàng (tức là thời gian cập nhật gần đây nhất của các sản phẩm CSS hiện có muộn hơn thời gian mới được đặt trong bản cập nhật). Nếu quá trình cập nhật diễn ra, thì thời gian cập nhật gần nhất sẽ được đặt thành thời gian làm mới này.

Nếu bạn không đặt chế độ này, thì bản cập nhật sẽ không bị ngăn và thời gian cập nhật gần đây nhất sẽ mặc định là thời gian CSS API nhận được yêu cầu này.

Nếu thao tác bị ngăn chặn, ngoại lệ bị huỷ sẽ được gửi.
attributes

Attributes

Danh sách thuộc tính sản phẩm của CSS.
custom_attributes[]

CustomAttribute

Danh sách các thuộc tính tuỳ chỉnh (do CSS cung cấp). Bạn cũng có thể dùng thuộc tính này để gửi mọi thuộc tính của quy cách nguồn cấp dữ liệu ở dạng chung (ví dụ: { "name": "size type", "value": "regular" }). Điều này rất hữu ích khi gửi những thuộc tính không được API hiển thị một cách rõ ràng, chẳng hạn như các thuộc tính bổ sung được dùng cho chương trình Mua trên Google.

CssProductStatus

Trạng thái của Sản phẩm CSS, các vấn đề về xác thực dữ liệu, tức là thông tin về Sản phẩm CSS được tính toán không đồng bộ.

Trường
destination_statuses[]

DestinationStatus

Vị trí xuất hiện dự kiến của sản phẩm.
item_level_issues[]

ItemLevelIssue

Danh sách tất cả vấn đề liên quan đến sản phẩm.
creation_date

Timestamp

Ngày tạo mặt hàng, ở định dạng ISO 8601.
last_update_date

Timestamp

Ngày cập nhật mặt hàng gần đây nhất, ở định dạng ISO 8601.
google_expiration_date

Timestamp

Ngày hết hạn của mặt hàng, ở định dạng ISO 8601.

DestinationStatus

Trạng thái đích của trạng thái sản phẩm.

Trường
destination

string

Tên của điểm đến
approved_countries[]

string

Danh sách mã quốc gia (ISO 3166-1 alpha-2) nơi Sản phẩm CSS được phê duyệt.
pending_countries[]

string

Danh sách mã quốc gia (ISO 3166-1 alpha-2) nơi Sản phẩm CSS đang chờ phê duyệt.
disapproved_countries[]

string

Danh sách mã quốc gia (ISO 3166-1 alpha-2) nơi Sản phẩm CSS bị từ chối.

ItemLevelIssue

ItemLevelIssue của trạng thái sản phẩm.

Trường
code

string

Mã lỗi của vấn đề.
servability

string

Vấn đề này ảnh hưởng như thế nào đến việc phân phát Sản phẩm CSS.
resolution

string

Người bán có thể giải quyết vấn đề hay không.
attribute

string

Tên của thuộc tính, nếu vấn đề là do một thuộc tính duy nhất gây ra.
destination

string

Vị trí xuất hiện mà vấn đề áp dụng.
description

string

Nội dung mô tả ngắn gọn về vấn đề bằng tiếng Anh.
detail

string

Nội dung mô tả chi tiết về vấn đề bằng tiếng Anh.
documentation

string

URL của một trang web để giúp giải quyết vấn đề này.
applicable_countries[]

string

Danh sách mã quốc gia (ISO 3166-1 alpha-2) mà vấn đề áp dụng cho Sản phẩm CSS.

DeleteAccountLabelRequest

Thông báo yêu cầu cho phương thức "DeleteAccountLabel".

Trường
name

string

Bắt buộc. Tên của nhãn cần xoá. Định dạng: accounts/{account}/labels/{label}

DeleteCssProductInputRequest

Thông báo yêu cầu cho phương thức DeleteCssProductInput.

Trường
name

string

Bắt buộc. Tên của tài nguyên đầu vào sản phẩm CSS cần xoá. Định dạng: accounts/{account}/cssProductInputs/{css_product_input}, trong đó phần cuối cùng css_product_input bao gồm 3 phần: contentLanguage~feedLabel~offerId. Ví dụ: accounts/123/cssProductInputs/de~DE~rawProvidedId123
supplemental_feed_id

int64

Mã nguồn cấp dữ liệu bổ sung Content API. Bạn không được đặt trường này nếu hành động áp dụng cho một nguồn cấp dữ liệu chính. Nếu bạn đặt trường này, thì thao tác với sản phẩm sẽ áp dụng cho một nguồn cấp dữ liệu bổ sung thay vì nguồn cấp dữ liệu Content API chính.

GetAccountRequest

Thông báo yêu cầu cho phương thức GetAccount.

Trường
name

string

Bắt buộc. Tên của tài khoản CSS/MC được quản lý. Định dạng: accounts/{account}
parent

string

Không bắt buộc. Chỉ bắt buộc khi truy xuất thông tin tài khoản Merchant Center. Miền CSS là tài nguyên mẹ của tài khoản Merchant Center. Định dạng: accounts/{account}

GetCssProductRequest

Thông báo yêu cầu cho phương thức GetCssProduct.

Trường
name

string

Bắt buộc. Tên của sản phẩm CSS cần truy xuất. Định dạng accounts/{account}/cssProducts/{css_product}

HeadlineOfferInstallment

Một thông báo đại diện cho việc trả góp.

Trường
months

int64

Số lần trả góp mà người mua phải trả.
amount

Price

Số tiền mà người mua phải trả mỗi tháng.
downpayment

Price

Số tiền thanh toán ban đầu mà người mua phải trả.

HeadlineOfferSubscriptionCost

SubscriptionCost của sản phẩm.

Trường
period

SubscriptionPeriod

Loại chu kỳ đăng ký. Sau đây là các giá trị được hỗ trợ: * "month" * "year"
period_length

int64

Số kỳ hạn thuê bao mà người mua phải trả.
amount

Price

Số tiền mà người mua phải trả cho mỗi kỳ thuê bao.

InsertCssProductInputRequest

Thông báo yêu cầu cho phương thức InsertCssProductInput.

Trường
parent

string

Bắt buộc. Tài khoản nơi Sản phẩm CSS này sẽ được chèn vào. Định dạng: accounts/{account}
css_product_input

CssProductInput

Bắt buộc. Đầu vào sản phẩm CSS cần chèn.
feed_id
(deprecated)

int64

Không bắt buộc. KHÔNG CÒN DÙNG NỮA. Bạn không bắt buộc phải có mã nguồn cấp dữ liệu cho sản phẩm của CSS. Mã nhận dạng nguồn cấp dữ liệu chính hoặc nguồn cấp dữ liệu bổ sung. Nếu Sản phẩm CSS đã tồn tại và mã nguồn cấp dữ liệu được cung cấp khác, thì Sản phẩm CSS sẽ được chuyển sang một nguồn cấp dữ liệu mới. Lưu ý: Hiện tại, các Dịch vụ so sánh giá (CSS) không cần cung cấp mã nguồn cấp dữ liệu vì chúng tôi tạo nguồn cấp dữ liệu ngay lập tức. Chúng tôi chưa hỗ trợ nguồn cấp dữ liệu bổ sung cho Sản phẩm CSS.

ListAccountLabelsRequest

Thông báo yêu cầu cho phương thức ListAccountLabels.

Trường
parent

string

Bắt buộc. Tài khoản mẹ. Định dạng: accounts/{account}
page_size

int32

Số lượng nhãn tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, thì hệ thống sẽ trả về tối đa 50 nhãn. Giá trị tối đa là 1000; các giá trị lớn hơn 1000 sẽ được chuyển đổi thành 1000.
page_token

string

Mã thông báo trang nhận được từ một lệnh gọi ListAccountLabels trước đó. Cung cấp thông tin này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListAccountLabels phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

ListAccountLabelsResponse

Thông báo phản hồi cho phương thức ListAccountLabels.

Trường
account_labels[]

AccountLabel

Nhãn của tài khoản được chỉ định.
next_page_token

string

Một mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có trang tiếp theo.

ListChildAccountsRequest

Thông báo yêu cầu cho phương thức ListChildAccounts.

Trường
parent

string

Bắt buộc. Tài khoản mẹ. Phải là một nhóm Dịch vụ so sánh giá hoặc miền. Định dạng: accounts/{account}
page_size

int32

Không bắt buộc. Số lượng tài khoản tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không chỉ định, hệ thống sẽ trả về tối đa 50 tài khoản. Giá trị tối đa là 100; các giá trị lớn hơn 100 sẽ được chuyển đổi thành 100.
page_token

string

Không bắt buộc. Mã thông báo trang nhận được từ một lệnh gọi ListChildAccounts trước đó. Cung cấp thông tin này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListChildAccounts phải khớp với lệnh gọi đã cung cấp mã thông báo trang.
label_id

int64

Nếu được đặt, chỉ những tài khoản người bán có nhiều khách hàng có mã nhận dạng nhãn đã cho mới được trả về.
full_name

string

Nếu được đặt, chỉ những tài khoản người bán có tên đã cho (phân biệt chữ hoa chữ thường) mới được trả về.

ListChildAccountsResponse

Thông báo phản hồi cho phương thức ListChildAccounts.

Trường
accounts[]

Account

Các tài khoản CSS/MC được trả về cho tài khoản mẹ CSS được chỉ định.
next_page_token

string

Một mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có trang tiếp theo.

ListCssProductsRequest

Thông báo yêu cầu cho phương thức ListCssProducts.

Trường
parent

string

Bắt buộc. Tài khoản/miền để liệt kê các sản phẩm CSS đã xử lý. Định dạng: accounts/{account}
page_size

int32

Số lượng sản phẩm tối đa của CSS cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Giá trị tối đa là 1000; các giá trị lớn hơn 1000 sẽ được chuyển đổi thành 1000. Nếu bạn không chỉ định, hệ thống sẽ trả về số lượng sản phẩm tối đa của CSS.
page_token

string

Mã thông báo trang nhận được từ một lệnh gọi ListCssProducts trước đó. Cung cấp thông tin này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListCssProducts phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

ListCssProductsResponse

Thông báo phản hồi cho phương thức ListCssProducts.

Trường
css_products[]

CssProduct

Các sản phẩm CSS đã được xử lý từ tài khoản được chỉ định. Đây là các sản phẩm CSS đã được xử lý sau khi bạn áp dụng các quy tắc và nguồn cấp dữ liệu bổ sung.
next_page_token

string

Một mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có trang tiếp theo.

ListQuotaGroupsRequest

Thông báo yêu cầu cho phương thức ListQuotaGroups.

Trường
parent

string

Bắt buộc. Tài khoản CSS sở hữu tập hợp các hạn mức và tài nguyên phương thức. Trong hầu hết các trường hợp, đây là miền CSS. Định dạng: accounts/{account}
page_size

int32

Không bắt buộc. Số lượng hạn mức tối đa cần trả về trong phản hồi, dùng để phân trang. Giá trị mặc định là 500; các giá trị trên 1000 sẽ được ép buộc thành 1000.
page_token

string

Không bắt buộc. Mã thông báo (nếu có) để truy xuất trang tiếp theo. Tất cả các thông số khác phải khớp với lệnh gọi ban đầu đã cung cấp mã thông báo trang.

ListQuotaGroupsResponse

Thông báo phản hồi cho phương thức ListMethodGroups.

Trường
quota_groups[]

QuotaGroup

Các phương thức, mức sử dụng hạn mức hiện tại và giới hạn cho mỗi nhóm. Tất cả các phương thức trong nhóm đều dùng chung hạn mức này. Các nhóm được sắp xếp theo thứ tự giảm dần dựa trên quota_usage.
next_page_token

string

Một mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có trang tiếp theo.

MethodDetails

Thông tin chi tiết về phương thức theo từng phương thức trong CSS API.

Trường
method

string

Chỉ có đầu ra. Tên của phương thức, ví dụ: cssproductsservice.listcssproducts.
version

string

Chỉ có đầu ra. Phiên bản API mà phương thức thuộc về.
subapi

string

Chỉ có đầu ra. API phụ mà phương thức thuộc về. Trong CSS API, giá trị này luôn là css.
path

string

Chỉ có đầu ra. Đường dẫn cho phương thức, chẳng hạn như v1/cssproductsservice.listcssproducts.

ProductDetail

Chi tiết sản phẩm.

Trường
section_name

string

Tiêu đề của phần dùng để nhóm một bộ chi tiết sản phẩm.
attribute_name

string

Tên của thông tin chi tiết sản phẩm.
attribute_value

string

Giá trị của chi tiết sản phẩm.

ProductDimension

Kích thước của sản phẩm.

Trường
value

double

Bắt buộc. Giá trị phương diện được biểu thị dưới dạng một số. Giá trị này có thể có độ chính xác tối đa là 4 chữ số thập phân.
unit

string

Bắt buộc. Đơn vị phương diện. Giá trị được chấp nhận là: * "in" * "cm"

ProductWeight

Trọng lượng của sản phẩm.

Trường
value

double

Bắt buộc. Trọng lượng được biểu thị dưới dạng một số. Trọng lượng có thể có độ chính xác tối đa là 4 chữ số thập phân.
unit

string

Bắt buộc. Đơn vị trọng lượng. Giá trị được chấp nhận là: * "g" * "kg" * "oz" * "lb"

QuotaGroup

Thông tin nhóm cho các phương thức trong CSS API. Tất cả các phương thức trong nhóm đều dùng chung hạn mức này. Ngay cả khi không có phương thức nào trong nhóm có mức sử dụng, thông tin cho nhóm vẫn được trả về.

Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của nhóm hạn mức. Định dạng: accounts/{account}/quotas/{group} Ví dụ: accounts/12345678/quotas/css-products-insert Lưu ý: Phần {group} không được đảm bảo tuân theo một mẫu cụ thể.
quota_usage

int64

Chỉ có đầu ra. Mức sử dụng hạn mức hiện tại, tức là số lượng lệnh gọi đã thực hiện trong một ngày nhất định cho các phương thức trong nhóm. Hạn mức hằng ngày sẽ được đặt lại vào lúc 12:00 trưa theo giờ UTC.
quota_limit

int64

Chỉ có đầu ra. Số lượng cuộc gọi tối đa được phép mỗi ngày cho nhóm.
quota_minute_limit

int64

Chỉ có đầu ra. Số lượng cuộc gọi tối đa được phép mỗi phút cho nhóm.
method_details[]

MethodDetails

Chỉ có đầu ra. Danh sách tất cả các phương thức mà hạn mức nhóm áp dụng.

SubscriptionPeriod

Kỳ hạn thuê bao của sản phẩm.

Enum
SUBSCRIPTION_PERIOD_UNSPECIFIED Cho biết rằng khoảng thời gian đăng ký không được chỉ định.
MONTH Cho biết rằng kỳ hạn thuê bao là tháng.
YEAR Cho biết rằng kỳ hạn thuê bao là năm.

UpdateAccountLabelRequest

Thông báo yêu cầu cho phương thức UpdateAccountLabel.

Trường
account_label

AccountLabel

Bắt buộc. Nhãn đã cập nhật. Bạn phải cung cấp tất cả các trường.

UpdateAccountLabelsRequest

Thông báo yêu cầu cho phương thức UpdateLabels.

Trường
name

string

Bắt buộc. Tên tài nguyên nhãn. Định dạng: accounts/{account}
label_ids[]

int64

Danh sách mã nhãn để ghi đè mã nhãn tài khoản hiện có. Nếu danh sách này trống, tất cả mã nhận dạng nhãn hiện được chỉ định sẽ bị xoá.
parent

string

Không bắt buộc. Bạn chỉ cần mã này khi cập nhật nhãn tài khoản MC. Miền CSS là tài nguyên mẹ của tài khoản Merchant Center. Định dạng: accounts/{account}

UpdateCssProductInputRequest

Thông báo yêu cầu cho phương thức UpdateCssProductInput.

Trường
css_product_input

CssProductInput

Bắt buộc. Tài nguyên đầu vào sản phẩm CSS cần cập nhật. Thông tin bạn gửi cũng sẽ được áp dụng cho sản phẩm CSS đã xử lý.
update_mask

FieldMask

Danh sách các thuộc tính sản phẩm CSS cần cập nhật.

Nếu bạn bỏ qua mặt nạ cập nhật, thì mặt nạ này sẽ được coi là mặt nạ trường ngầm tương đương với tất cả các trường được điền sẵn (có giá trị không trống).

Các thuộc tính được chỉ định trong mặt nạ cập nhật mà không có giá trị được chỉ định trong phần nội dung sẽ bị xoá khỏi sản phẩm CSS.

Bạn chỉ có thể chỉ định mặt nạ cập nhật cho các trường cấp cao nhất trong thuộc tính và thuộc tính tuỳ chỉnh.

Để chỉ định mặt nạ cập nhật cho các thuộc tính tuỳ chỉnh, bạn cần thêm tiền tố custom_attribute..

Chúng tôi không hỗ trợ việc cung cấp giá trị đặc biệt "*" để thay thế toàn bộ sản phẩm CSS.