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. 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:

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’
}