Quản lý nhãn CSS

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. 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 được liên kết với nhóm. Các dịch vụ Content API này cung cấp các tính năng tương đương theo chương trình với một số tính năng có trong Comparison Shopping Service Center.

Để biết thêm thông tin về CSS, hãy xem bài viết 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à 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, những tài khoản này đặt 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 một nhóm CSS.
  • Tài khoản Merchant Center là những người bán mà miền CSS đặt quảng cáo Mua sắm. Các CSS có thể được 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 riêng lẻ. Mỗi tài khoản Merchant Center chỉ có thể được 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 2 loại nhãn:

  • Nhãn thủ công do miền CSS tạo và chỉ định cho tài khoản Merchant Center, đồng thời do nhóm CSS tạo và chỉ định cho miền CSS.
  • CSS Center tự động tạo và chỉ định nhãn tự động cho các tài khoản Merchant Center. Nhãn tự động có sẵn cho nhiều loại chỉ số tài khoản và có thể giúp bạn xác định những tài khoản quan trọng cũng như hoạt động đáng kể của tài khoản.

Để biết thêm thông tin về các loại nhãn, bao gồm cả nhãn tự động hiện có, 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 cho CSS:

Khi gọi các điểm cuối accounts dưới dạng miền CSS, hãy lưu ý những yêu cầu sau:

  • Miền CSS phải cung cấp cssId thay vì merchantId.
  • Miền CSS phải cung cấp một tham số truy vấn là view=CSS.
  • 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ể sử dụng phương thức accounts.labels.create để tạo 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, nhãn cho các loại tài khoản khác nhau là riêng biệt và không thể dùng thay thế cho nhau. Để tạo nhãn cấp miền (có thể áp dụng cho các 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. Để tạo nhãn ở cấp nhóm (có thể áp dụng cho các miền CSS được 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 nhãn tài khoản chính ở 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 được liên kết với miền. Để tạo nhãn, hãy thực hiện 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 một 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 tài khoản Merchant Center được liên kết với một miền CSS. Ví dụ sau đây minh hoạ cách áp dụng nhãn key-accounts được tạo trong ví dụ trước cho một trong những tài khoản Merchant Center quan trọng nhất của bạn.

Để áp dụng nhãn, hãy thực hiện 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/cssId/accounts/subaccountId/updatelabels/

{
 "labelIds": [‘123’] // ‘key-accounts’
}

Ví dụ: Sử dụng nhãn để lọ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 một miền CSS, bạn có thể sử dụng phương thức accounts.list và truyền tham số truy vấn nhãn trong yêu cầu để chỉ trả về những tài khoản có nhãn đó. Ví dụ sau đây minh hoạ cách lọc các tài khoản Merchant Center được liên kết với một miền CSS, bằng cách sử dụng id (123) của nhãn key-accounts được tạo trong ví dụ Tạo nhãn. Để truy xuất các tài khoản, 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

Bạn 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 để chỉ định nhãn cho một miền CSS liên kết với một nhóm CSS. Ví dụ sau đây minh hoạ cách áp dụng nhãn ở cấp nhóm key-domains đượ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 nhãn cho miền CSS và tài khoản Merchant Center là 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 accountId.

Để áp dụng nhãn, hãy thực hiện 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/cssGroupId/csses/cssDomainId/updatelabels/

{
 "labelIds": [‘456’] // ‘key-domains’
}