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. Grup CSS dapat memberi label dan mencantumkan domain CSS yang berafiliasi dengan grup. Layanan Content API ini menyediakan padanan terprogram untuk beberapa fitur yang tersedia di Comparison Shopping Service Center.

Untuk mengetahui informasi selengkapnya 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 menayangkan iklan Shopping untuk penjual. Setiap domain CSS hanya dapat menjadi bagian dari satu grup CSS.
  • Akun Merchant Center adalah penjual yang domain CSS-nya menempatkan iklan Shopping. CSS dapat dikaitkan dengan beberapa jenis akun Merchant Center yang berbeda, termasuk akun multiklien (MCA) dan akun penjual individual. 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 dibuat dan ditetapkan secara otomatis 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 berbagai jenis akun 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 terkait dengan grup, gunakan ID grup CSS sebagai accountId saat membuat label.

Contoh berikut menunjukkan cara membuat label akun utama tingkat 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 dalam contoh sebelumnya ke salah satu akun Merchant Center terpenting Anda.

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 untuk menampilkan hanya akun dengan label tersebut. Contoh berikut menunjukkan cara memfilter akun Merchant Center yang terkait dengan domain CSS, menggunakan id (123) label key-accounts yang dibuat dalam contoh Membuat label. Untuk mengambil akun, buat permintaan GET menggunakan URL berikut:

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

Tidak diperlukan isi permintaan.

Contoh: Menerapkan label ke domain CSS

Anda juga dapat menggunakan metode csses.updatelabels untuk menetapkan label ke domain CSS yang berafiliasi dengan grup CSS. Contoh berikut menunjukkan cara menerapkan label tingkat grup key-domains yang dibuat menggunakan metode accounts.labels.create ke salah satu akun domain CSS terpenting Anda. Perlu diingat bahwa label untuk domain CSS dan akun Merchant Center terpisah. Label tingkat grup harus dibuat menggunakan ID grup 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’
}