Dịch vụ so sánh giá (CSS) có thể thay mặt người bán đặt quảng cáo mua sắm trên Google ở 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 nhãn. 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 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 được liên kết với nhóm. Các dịch vụ Content API này cung cấp tính năng có lập trình tương đương với một số tính năng có trong Trung tâm dịch vụ so sánh giá.
Để 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 sử dụng nhãn trong CSS Center, hãy xem bài viết 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 miền CSS.
- Miền CSS là tài khoản của chính các CSS, nơi hiển thị quảng cáo 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 tài khoản Merchant Center, bao gồm cả tài khoản nhiều khách hàng (MCA) và tài khoản người bán cá nhân. Mỗi tài khoản Merchant Center chỉ có thể liên kết với một miền CSS. Để biết thêm thông tin về các loại tài khoản Merchant Center, hãy xem bài viết 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 được tạo và chỉ định cho các tài khoản Merchant Center theo miền CSS và cho các miền CSS theo nhóm CSS.
- Nhãn tự động là do CSS Center tạo và chỉ định tự động cho các tài khoản Merchant Center. Bạn có thể sử dụng nhãn tự động cho nhiều loại 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 quan trọng trong tài khoản.
Để biết thêm thông tin về các loại nhãn, bao gồm cả các nhãn tự động có sẵn, hãy xem bài viết 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à tài khoản Merchant Center. Để 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. Để biết 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ác nhãn áp dụng cho từng 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. Ví dụ: hãy xem bài viết Sử dụng nhãn để lọc các tài khoản Merchant Center.accounts.get
: Cho phép bạn truy xuất các nhãn á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 phần Á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 ý các yêu cầu sau:
- 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. Bạn có thể áp dụng nhãn cho các miền CSS và tài khoản Merchant Center. Tuy nhiên, các nhãn cho
các loại tài khoản khác nhau là riêng biệt và không thể sử dụng thay thế cho nhau. Để tạo nhãn ở cấp miền mà bạn có thể áp dụng cho các tài khoản Merchant Center 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. Để tạo nhãn cấp nhóm mà bạn có thể áp dụng cho các miền CSS 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 minh hoạ cách tạo nhãn tài khoản khoá cấp miền. Sau đó, bạn có thể áp dụng nhãn này 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 cách sử dụng URL và nội dung yêu cầu sau:
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
để gán nhãn cho tài khoản Merchant
Center liên kết với 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 một trong các tài khoản Merchant Center quan trọng nhất của bạn.
Để áp dụng nhãn, hãy tạo yêu cầu POST
bằng URL sau đây và nội dung yêu cầu:
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 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 tham số truy vấn nhãn vào yêu cầu để chỉ trả về những tài khoản có nhãn đó. Ví dụ sau minh hoạ cách lọc các tài khoản Merchant Center
liên kết với miền CSS bằng cách sử dụng id
(123
) của nhãn khoá-tài khoản
đã tạo trong ví dụ Tạo nhãn. Để truy xuất accoung, hãy thực hiện yêu cầu GET
bằ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 miền CSS
liên kết với nhóm CSS. Ví dụ sau minh hoạ cách áp dụng nhãn cấp nhóm miền khoá được tạo bằng phương thức accounts.labels.create
cho một trong những tài khoản miền CSS quan trọng nhất của bạn. Xin lưu ý rằng các nhãn cho miền CSS và tài khoản Merchant Center
là nhãn tách 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
accountId
của nhóm đó.
Để áp dụng nhãn, hãy tạo yêu cầu POST
bằng URL sau đây và nội dung yêu cầu:
https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
"labelIds": [‘456’] // ‘key-domains’
}