Pengelolaan label CSS

Layanan Perbandingan Belanja (CSS) dapat menempatkan iklan Shopping di Google atas nama penjual di negara tempat program CSS tersedia. Content API memungkinkan domain CSS dan grup CSS mengatur akun terkaitnya menggunakan label. Domain CSS dapat mencantumkan, memberi label, dan memfilter akun Merchant Center yang terkait dengan domain. Kelompok CSS dapat memberi label dan membuat daftar domain CSS yang berafiliasi dengan kelompok tersebut. Layanan Content API ini memberikan layanan yang setara terprogram dengan beberapa fitur yang tersedia di Pusat Layanan Perbandingan Belanja.

Untuk mengetahui informasi lebih lanjut tentang CSS, lihat Layanan Perbandingan Belanja. Untuk mengetahui informasi tentang cara menggunakan label di CSS Center, lihat Menggunakan label akun di Comparison Shopping Service Center.

Jenis akun CSS

CSS menggunakan tiga jenis akun berikut:

  • Grup CSS adalah akun tingkat teratas yang dapat berisi satu atau beberapa domain CSS.
  • Domain CSS adalah akun untuk CSS itu sendiri, yang menempatkan iklan Shopping atas nama penjual. Setiap domain CSS hanya dapat dimiliki oleh satu kelompok CSS.
  • Akun Merchant Center adalah penjual yang domain CSS-nya menempatkan iklan Shopping. CSS dapat dikaitkan dengan beberapa jenis akun Merchant Center, termasuk akun multiklien (MCA) dan akun penjual perorangan. Setiap akun Merchant Center hanya dapat dikaitkan dengan satu domain CSS. Untuk mengetahui informasi selengkapnya tentang berbagai jenis akun Merchant Center, lihat Jenis akun di Comparison Shopping Service Center.

Jenis label CSS

CSS menggunakan dua jenis label:

  • Label manual dibuat dan ditetapkan ke akun Merchant Center oleh domain CSS, dan ke domain CSS oleh grup CSS.
  • Label otomatis otomatis dibuat dan ditetapkan ke akun Merchant Center oleh CSS Center. Label otomatis tersedia untuk berbagai jenis metrik akun dan dapat membantu Anda mengidentifikasi akun penting dan aktivitas akun yang signifikan.

Untuk mengetahui informasi selengkapnya tentang jenis label, termasuk label otomatis yang tersedia, lihat Menggunakan label akun di Comparison Shopping Service Center.

Fungsi dan endpoint Content API untuk CSS

Content API menawarkan endpoint berikut untuk CSS:

Saat memanggil endpoint accounts sebagai domain CSS, perhatikan persyaratan berikut:

  • Domain CSS harus memberikan cssId, bukan merchantId.
  • Domain CSS harus menyediakan parameter kueri view=CSS.
  • Domain CSS harus memberikan ID akun Merchant Center terkaitnya sebagai accountId.

Contoh: Membuat label

Anda dapat menggunakan metode accounts.labels.create untuk membuat label baru. Label dapat diterapkan ke domain CSS dan akun Merchant Center. Namun, label untuk jenis akun yang berbeda bersifat terpisah dan tidak dapat digunakan secara bergantian. Untuk membuat label tingkat domain yang dapat diterapkan ke akun Merchant Center yang terkait dengan domain, gunakan ID domain CSS sebagai accountId saat membuat label. Untuk membuat label tingkat grup, yang dapat diterapkan ke domain CSS yang berafiliasi dengan grup, gunakan ID kelompok CSS sebagai accountId saat membuat label.

Contoh berikut menunjukkan cara membuat label akun kunci level domain, yang kemudian dapat diterapkan ke akun Merchant Center yang terkait dengan domain. Untuk membuat label, buat permintaan POST menggunakan URL dan isi permintaan berikut:

https://shoppingcontent.googleapis.com/content/v2.1/accounts/accountId/labels

{
 "name": "key-accounts",
 "description": "All accounts with over a million products"
}

Contoh: Menerapkan label ke akun Merchant Center

Anda dapat menggunakan metode accounts.updatelabels untuk menetapkan label ke akun Merchant Center yang terkait dengan domain CSS. Contoh berikut menunjukkan cara menerapkan label key-accounts yang dibuat di contoh sebelumnya ke salah satu akun Merchant Center Anda yang paling penting.

Untuk menerapkan label, buat permintaan POST menggunakan URL dan isi permintaan berikut:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/

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

Contoh: Menggunakan label untuk memfilter akun Merchant Center

Setelah membuat dan menerapkan label ke akun Merchant Center yang terkait dengan domain CSS, Anda dapat menggunakan metode accounts.list dan meneruskan parameter kueri label dalam permintaan agar hanya menampilkan akun dengan label tersebut. Contoh berikut menunjukkan cara memfilter akun Merchant Center yang terkait dengan domain CSS, menggunakan id (123) dari label akun kunci yang dibuat dalam contoh Membuat label. Untuk mengambil accoung, buat permintaan GET menggunakan URL berikut:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123

Isi permintaan tidak diperlukan.

Contoh: Menerapkan label ke domain CSS

Anda juga dapat menggunakan metode csses.updatelabels untuk menetapkan label ke domain CSS yang berafiliasi dengan kelompok CSS. Contoh berikut menunjukkan cara menerapkan label tingkat grup key-domains yang dibuat menggunakan metode accounts.labels.create ke salah satu akun domain CSS Anda yang paling penting. Perlu diingat bahwa label untuk domain CSS dan akun Merchant Center terpisah. Label tingkat grup harus dibuat menggunakan ID kelompok CSS sebagai accountId.

Untuk menerapkan label, buat permintaan POST menggunakan URL dan isi permintaan berikut:

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

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