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 một 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 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.
ListAccountLabels

rpc ListAccountLabels(ListAccountLabelsRequest) returns (ListAccountLabelsResponse)

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

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 trong mã tài khoản CSS đã chỉ định và lọc theo mã nhãn và tên tài khoản (không bắt buộ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.
UpdateLabels

rpc UpdateLabels(UpdateAccountLabelsRequest) returns (Account)

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

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á dữ liệu đầu vào về Sản phẩm CSS khỏi tài khoản CSS Center.

Sau khi xoá, có thể mất vài phút thì dữ liệu đầ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 CssProductInput lên tài khoản CSS Center của bạn. Nếu đã có một mục nhập có cùng contentLanguage, identity, feedLabel và feedId, thì phương thức này sẽ thay thế mục nhập đó.

Sau khi chèn, cập nhật hoặc xoá dữ liệu đầ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ý.

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 dữ liệu đầu vào hiện có về Sản phẩm CSS trong tài khoản CSS Center.

Sau khi chèn, cập nhật hoặc xoá dữ liệu đầ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ý.

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ụ để lấy và liệt kê trên Sản phẩm CSS(còn gọi là Ưu đãi 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 của bạn. Sau khi chèn, cập nhật hoặc xoá dữ liệu đầu vào về sản phẩm, có thể mất vài phút thì bạn mới có thể truy xuất sản phẩm cuối cùng đã 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.
ListCssProducts

rpc ListCssProducts(ListCssProductsRequest) returns (ListCssProductsResponse)

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

Sau khi chèn, cập nhật hoặc xoá dữ liệu đầu vào về 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ý và 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 hạn mức gọi phương thức cho mỗi phương thức API CSS.

ListQuotaGroups

rpc ListQuotaGroups(ListQuotaGroupsRequest) returns (ListQuotaGroupsResponse)

Liệt kê hạn mức cuộc gọi hằng ngày và mức sử dụng theo nhóm cho tài khoản CSS Center của bạ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.

Tài khoản

Thông tin về tài khoản CSS/MC.

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 được tạo theo cách thủ công do tài khoản mẹ CSS chỉ định cho tài khoản CSS/MC.
automatic_label_ids[]

int64

Mã nhãn được tạo tự động do CSS Center 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 CSS cho miền CSS; miền CSS cho tài khoản MC. Chỉ được trả về nếu người dùng có quyền truy cập vào tài khoản mẹ. Lưu ý: Đối với tài khoản phụ MC, đâ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 làm phẳng hệ 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 CSS.
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 MC.
MC_MARKETPLACE_MCA Tài khoản MCA của trang web thương mại trên MC.
MC_OTHER_MCA Tài khoản MCA khác của MC.
MC_STANDALONE Tài khoản MC độc lập.
MC_MCA_SUBACCOUNT Tài khoản phụ MCA của MC.

AccountLabel

Nhãn do miền CSS hoặc nhóm CSS 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 chứa nhãn này.
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á sản phẩm CSS cao.
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 các 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 [https://support.google.com/merchants/answer/6324497](loại kích thước)).
product_details[]

ProductDetail

Thông số kỹ thuật hoặc chi tiết bổ sung về sản phẩm.
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 dấu đầu dòng mô tả những điểm nổi bật có liên quan nhất của một sản phẩm.
certifications[]

Certification

Danh sách chứng chỉ mà CSS xác nhận quyền sở hữu cho một sản phẩm cụ thể.
expiration_date

Timestamp

Ngày hết hạn của mặt hàng, như đượ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 hơn 2 ngày kể từ ngày hết hạn thì mục đó mới 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 đánh dấu trong Merchant Center). Các đích đến mặc định luôn được đưa vào trừ phi đích đến đó đượ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 đánh dấu không được chọn trong Merchant Center).
headline_offer_installment

HeadlineOfferInstallment

Số lượng và số tiền trả góp 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 đối với 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 của 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 mặt hàng theo Google (xem Dữ liệu 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 các danh mục sản phẩm của Google được chỉ định tự động thông qua API.
adult

bool

Đặt thành đúng nếu mục đó 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

Liệu 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à mặt hàng nhắm đến.
material

string

Chất liệu làm 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. Chỉ được phép một giá trị. Đối với các biến thể có kích thước khác nhau, hãy chèn một sản phẩm riêng biệt cho mỗi kích thước có cùng giá trị itemGroupId (xem [https://support.google.com/merchants/answer/6324492](định nghĩa về kích thước)).
size_system

string

Hệ thống trong đó 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 dừng.
custom_label_0

string

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

string

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

string

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

string

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

string

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

Giấy chứng nhận

Giấy chứng nhận cho 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 hiệu suất 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 chỉ 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 "CreateAccountLanel".

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ô duy nhất của bạn cho sản phẩm.
content_language

string

Chỉ có đầu ra. Mã ngôn ngữ ISO 639-1 gồm hai chữ cái của sản phẩm.
feed_label

string

Chỉ có đầu ra. Nhãn nguồn cấp dữ liệu cho 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 bất kỳ thuộc tính nào của thông số kỹ thuật 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 các thuộc tính không được API hiển thị rõ ràng, chẳng hạn như các thuộc tính bổ sung 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 sản phẩm, vấn đề về việc xác thực dữ liệu, tức là thông tin về 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 dữ liệu đầ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 đã xử lý. Định dạng: accounts/{account}/cssProducts/{css_product} "
raw_provided_id

string

Bắt buộc. Giá trị nhận dạng duy nhất của bạn cho Sản phẩm CSS. Điều này cũng áp dụng cho dữ liệu đầu vào Sản phẩm CSS và Sản phẩm CSS đã xử lý. Chúng tôi chỉ cho phép mã nhận dạng có 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 hai 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 đó, phải luôn là mã vùng hợp lệ. Ví dụ: "DE" cho Đức, "FR" cho Pháp.
freshness_time
(deprecated)

Timestamp

ĐÃ NGỪNG SỬ DỤNG. Thay vào đó, hãy sử dụng expiration_date. Biểu thị phiên bản hiện tại (mới) của Sản phẩm CSS. Bạn có thể sử dụng thuộc tính này để duy trì thứ tự phù hợp khi thực hiện nhiều lần cập nhật cùng một lúc.

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

Nếu bạn đặt giá trị này, hệ thống sẽ ngăn việc cập nhật nếu phiên bản mới hơn của mặt hàng đã tồn tại trong hệ thống của chúng tôi (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 đây nhất sẽ được đặt thành thời gian mới này.

Nếu bạn không đặt giá trị này, quá trình cập nhật sẽ không bị ngăn chặn và thời gian cập nhật gần đây nhất sẽ mặc định là thời điểm 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 các thuộc tính Sản phẩm 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 bất kỳ thuộc tính nào của thông số kỹ thuật nguồn cấp dữ liệu ở dạng chung (ví dụ: { "name": "size type", "value": "regular" }). Điều này hữu ích khi gửi các thuộc tính không được API hiển thị rõ ràng, chẳng hạn như các thuộc tính bổ sung 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

Đích đế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ục 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 đích đế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

Mức độ ảnh hưởng của vấn đề này đến việc phân phát Sản phẩm CSS.
resolution

string

Liệu 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 gây ra.
destination

string

Đích đế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 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) nơi 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 nguồn cấp dữ liệu chính. Nếu bạn đặt trường này, thì hành động sản phẩm sẽ áp dụng cho 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 MC. Miền CSS là tài nguyên mẹ của tài khoản MC. Đị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.

HeadlineOfferInstallment

Thông báo đại diện cho khoản 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 trả trước một phần mà người mua phải trả.

HeadlineOfferSubscriptionCost

SubscriptionCost của sản phẩm.

Trường
period

SubscriptionPeriod

Loại thời hạn thuê bao. Các giá trị được hỗ trợ là: * "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. Định dạng: accounts/{account}
css_product_input

CssProductInput

Bắt buộc. Thông tin sản phẩm CSS cần chèn.
feed_id
(deprecated)

int64

Không bắt buộc. ĐÃ NGỪNG SỬ DỤNG. Bạn không bắt buộc phải có mã nguồn cấp dữ liệu cho Sản phẩm CSS. Mã nguồn cấp dữ liệu chính hoặc 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, 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 không chỉ định, hệ thống sẽ trả về tối đa 50 nhãn. Giá trị tối đa là 1000; các giá trị trên 1000 sẽ được chuyển đổi thành 1000.
page_token

string

Mã thông báo trang, nhận được từ lệnh gọi ListAccountLabels trước đó. Cung cấp giá trị 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

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

string

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 CSS hoặc miền CSS. Đị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ị trên 100 sẽ được ép thành 100.
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListChildAccounts trước đó. Cung cấp giá trị 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 bạn đặt giá trị này, hệ thống sẽ chỉ trả về những tài khoản MC có mã nhãn đã cho.
full_name

string

Nếu bạn đặt giá trị này, hệ thống sẽ chỉ trả về những tài khoản MC có tên đã cho (có phân biệt chữ hoa chữ thường).

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 đã chỉ định.
next_page_token

string

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 để đăng danh sách Sản phẩm CSS đã xử lý. Định dạng: accounts/{account}
page_size

int32

Số lượng Sản phẩm CSS tối đa 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ị trê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 CSS tối đa.
page_token

string

Mã thông báo trang, nhận được từ lệnh gọi ListCssProducts trước đó. Cung cấp giá trị 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 đã xử lý từ tài khoản được chỉ định. Đây là những sản phẩm CSS đã được xử lý sau khi áp dụng các quy tắc và nguồn cấp dữ liệu bổ sung.
next_page_token

string

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 phương thức và tài nguyên. 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. Mặc định là 500; các giá trị trên 1000 sẽ được ép 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

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. Hạn mức được chia sẻ giữa tất cả các phương thức trong nhóm. 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ã 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

Thông tin chi tiết về sản phẩm.

Trường
section_name

string

Tiêu đề mục dùng để nhóm một tập hợp thông tin chi tiết về sản phẩm.
attribute_name

string

Tên của 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 diễn dưới dạng 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. Các 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 số được biểu thị dưới dạng số. Độ chính xác tối đa của trọng số là 4 chữ số thập phân.
unit

string

Bắt buộc. Đơn vị trọng lượng. Các 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. Hạn mức được chia sẻ giữa tất cả các phương thức trong nhóm. Ngay cả khi không có phương thức nào trong nhó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 nhất thiết phải 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, nghĩa là số lệnh gọi đã thực hiện vào một ngày nhất định cho các phương thức trong nhóm. Hạn mức hạn mức hằng ngày được đặt lại vào lúc 12:00 trưa theo giờ UTC.
quota_limit

int64

Chỉ có đầu ra. Số lệnh 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 áp dụng hạn mức nhóm.

SubscriptionPeriod

Thời hạn thuê bao của sản phẩm.

Enum
SUBSCRIPTION_PERIOD_UNSPECIFIED Cho biết rằng thời hạn thuê bao không được chỉ định.
MONTH Cho biết thời hạn thuê bao là tháng.
YEAR Cho biết thời 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 hiện được chỉ định sẽ bị xoá.
parent

string

Không bắt buộc. Chỉ bắt buộc 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 MC. Đị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 ẩn 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..

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