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 những 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 liên kết với nhóm. Các dịch vụ Content API này cung cấp phương thức có lập trình tương đương với một số tính năng trong Trung tâm dịch vụ so sánh giá.

Để 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 làm việc với các 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 đặ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 về 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. CSS có thể liên kết với nhiều loại tài khoản Merchant Center, trong đó 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 là do các miền CSS tạo và gán cho tài khoản Merchant Center cho tài khoản Merchant Center, và do các nhóm CSS tạo và gán cho miền CSS.
  • Nhãn tự động do CSS Center tạo và chỉ định 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 và 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 cho CSS

Content API cung cấp các điểm cuối sau đây cho CSS:

Khi gọi điểm cuối accounts dưới dạng miền CSS, hãy lưu ý các 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 tham số truy vấn 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ể sử 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 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 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 liên kết với nhóm, hãy 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 đó, nhãn này 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 thực hiện yêu cầu POST bằ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 một 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 tài khoản chính đã 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 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 đượ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 tham số truy vấn nhãn trong yêu cầu của mình để chỉ trả lại những tài khoản có nhãn đó. Ví dụ sau minh hoạ cách lọc những 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 tài khoản khoá được tạo trong ví dụ về cách Tạo nhãn. Để truy xuất tài khoản, hãy tạo 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 một 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 khoá-miền được tạo bằng phương thức accounts.labels.create cho một trong các 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à riêng biệt. Bạn phải tạo các nhãn ở cấp nhóm bằng cách dùng mã nhóm CSS làm accountId.

Để áp dụng nhãn, hãy tạo yêu cầu POST bằng URL sau và nội dung yêu cầu:

https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/

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