Dịch vụ so sánh giá (CSS) có thể thay mặt họ đặt quảng cáo Mua sắm trên Google người bán tại những quốc gia có chương trình CSS. Content API cho phép các miền CSS và nhóm CSS sắp xếp các tài khoản được liên kết bằng cách sử dụng . Các miền CSS có thể liệt kê, gắn nhãn và lọc các tài khoản Merchant Center được liên kết với miền. Các nhóm CSS có thể gắn nhãn và liệt kê các miền CSS liên kết với nhóm. Các dịch vụ Content API này cung cấp tính năng tương đương với một số tính năng hiện có trong giải pháp So sánh giá Trung tâm dịch vụ.
Để biết thêm thông tin về CSS, hãy xem Dịch vụ so sánh giá. Để biết thông tin về cách làm việc với nhãn trong CSS Center, hãy xem Sử dụng nhãn tài khoản trong Comparison Shopping Service Center.
Các loại tài khoản CSS
CSS sử dụng 3 loại tài khoản sau:
- Nhóm CSS là các tài khoản cấp cao nhất có thể chứa một hoặc nhiều CSS miền.
- Miền CSS là tài khoản của chính các CSS đó, nơi đặt các dịch vụ Mua sắm thay mặt cho người bán. Mỗi miền CSS chỉ có thể thuộc về một nhóm CSS.
- Tài khoản Merchant Center là những người bán mà các miền CSS đặt Quảng cáo Mua sắm. CSS có thể liên kết với nhiều loại Người bán khác nhau Tài khoản Center, bao gồm cả tài khoản nhiều khách hàng (MCA) và người bán cá nhân tài khoản. Mỗi tài khoản Merchant Center chỉ có thể liên kết với một CSS miền. Để biết thêm thông tin về các loại tài khoản Merchant Center, xem Các loại tài khoản trong Comparison Shopping Service Center.
Các loại nhãn CSS
CSS sử dụng hai loại nhãn:
- Nhãn thủ công do CSS tạo và chỉ định cho các tài khoản Merchant Center và miền CSS theo nhóm CSS.
- Nhãn tự động được tạo tự động và chỉ định cho Merchant Center thông qua CSS Center. Nhãn tự động hiện có sẵn cho nhiều loại các chỉ số tài khoản và có thể giúp bạn xác định các tài khoản quan trọng cũng như hoạt động tài khoản.
Để biết thêm thông tin về các loại nhãn, bao gồm cả chế độ cài đặt tự động nhãn, xem Sử dụng nhãn tài khoản trong Comparison Shopping Service Center.
Chức năng và điểm cuối của Content API dành cho CSS
Content API cung cấp các điểm cuối sau đây cho CSS:
accounts.labels
: Cho phép bạn tạo, truy xuất và sửa đổi nhãn để áp dụng cho miền CSS và Người bán Tài khoản trung tâm. Để biết ví dụ, hãy xem phần Tạo nhãn.accounts.updatelabels
: Cho phép bạn áp dụng nhãn cho một tài khoản Merchant Center. Ví dụ: hãy xem bài viết Áp dụng nhãn cho tài khoản Merchant Center.accounts.list
: Cho phép bạn truy xuất tất cả tài khoản Merchant Center liên kết với miền CSS, bao gồm các nhãn được áp dụng cho mỗi tài khoản. Bạn cũng có thể lọc theo nhãnid
để truy xuất một nhóm nhỏ các tài khoản được liên kết. Để biết ví dụ, hãy xem Sử dụng nhãn để lọc tài khoản Merchant Center.accounts.get
: Cho phép bạn để truy xuất các nhãn được áp dụng cho một tài khoản Merchant Center.csses
: Cho phép bạn xem và quản lý mối liên kết giữa nhãn và miền CSS. Để biết ví dụ, hãy xem Áp dụng nhãn cho miền CSS.
Khi gọi các điểm cuối accounts
dưới dạng miền CSS, hãy lưu ý những điều sau
các yêu cầu:
- Các miền CSS phải cung cấp
cssId
thay vìmerchantId
. - Các miền CSS phải cung cấp tham số truy vấn là
view=CSS
. - Các miền CSS phải cung cấp mã tài khoản Merchant Center được liên kết dưới dạng
accountId
.
Ví dụ: Tạo nhãn
Bạn có thể dùng phương thức accounts.labels.create
để tạo một nhãn mới. Nhãn
có thể áp dụng cho miền CSS và tài khoản Merchant Center. Tuy nhiên, nhãn cho
các loại tài khoản khác nhau riêng biệt và không thể sử dụng thay thế cho nhau. Người nhận
tạo một nhãn ở cấp miền để áp dụng cho tài khoản Merchant Center
được liên kết với miền đó, hãy sử dụng mã miền CSS làm accountId
khi
tạo nhãn. Cách tạo nhãn ở cấp nhóm có thể áp dụng cho CSS
các miền liên kết với nhóm đó, hãy sử dụng mã nhóm CSS làm accountId
khi
tạo nhãn.
Ví dụ sau đây minh hoạ cách tạo tài khoản khoá cấp miền
mà sau đó có thể được áp dụng cho các tài khoản Merchant Center liên kết với
miền. Để tạo nhãn, hãy đưa ra yêu cầu POST
bằng URL sau và
nội dung yêu cầu:
https://shoppingcontent.googleapis.com/content/v2.1/accounts/accountId/labels
{
"name": "key-accounts",
"description": "All accounts with over a million products"
}
Ví dụ: Áp dụng nhãn cho tài khoản Merchant Center
Bạn có thể sử dụng phương thức accounts.updatelabels
để chỉ định nhãn cho một Người bán
Tài khoản Center được liên kết với một miền CSS. Ví dụ sau minh hoạ
cách áp dụng nhãn khoá-tài khoản đã tạo trong ví dụ trước cho tài khoản
của các tài khoản Merchant Center quan trọng nhất của bạn.
Để áp dụng nhãn, hãy gửi yêu cầu POST
bằng URL và yêu cầu sau
nội dung:
https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/
{
"labelIds": [‘123’] // ‘key-accounts’
}
Ví dụ: Sử dụng nhãn để lọc các tài khoản Merchant Center
Sau khi tạo và áp dụng nhãn cho các tài khoản Merchant Center được liên kết
với miền CSS, bạn có thể sử dụng phương thức accounts.list
và chuyển nhãn
tham số truy vấn trong yêu cầu của bạn nhằm chỉ trả lại các tài khoản có nhãn đó. Chiến lược phát hành đĩa đơn
ví dụ sau minh hoạ cách lọc các tài khoản Merchant Center
liên kết với một miền CSS, bằng cách sử dụng id
(123
) của tài khoản khoá
nhãn được tạo trong ví dụ Tạo nhãn. Để truy xuất
accoungs, hãy thực hiện một yêu cầu GET
bằng cách sử dụng URL sau:
https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123
Không cần nội dung yêu cầu.
Ví dụ: Áp dụng nhãn cho miền CSS
Bạn cũng có thể sử dụng phương thức csses.updatelabels
để gán nhãn cho CSS
được liên kết với một nhóm Dịch vụ so sánh giá (CSS). Ví dụ sau đây minh hoạ cách
áp dụng nhãn cấp nhóm miền chính được tạo bằng
accounts.labels.create
sang một trong những miền CSS quan trọng nhất của bạn
tài khoản. Xin lưu ý rằng các nhãn cho miền CSS và tài khoản Merchant Center
đều riêng biệt. Bạn phải tạo nhãn ở cấp nhóm bằng cách sử dụng mã nhóm CSS làm nhãn
accountId
.
Để áp dụng nhãn, hãy gửi yêu cầu POST
bằng URL và yêu cầu sau
nội dung:
https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
"labelIds": [‘456’] // ‘key-domains’
}