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:
accounts.labels
: Memungkinkan Anda membuat, mengambil, dan mengubah label untuk diterapkan ke akun domain CSS dan Merchant Center. Sebagai contoh, lihat Membuat label.accounts.updatelabels
: Memungkinkan Anda menerapkan label ke satu akun Merchant Center. Sebagai contoh, lihat Menerapkan label ke akun Merchant Center.accounts.list
: Memungkinkan Anda mengambil semua akun Merchant Center yang terkait dengan domain CSS, termasuk label yang diterapkan ke setiap akun. Anda juga dapat memfilter menurut labelid
untuk mengambil subkumpulan akun terkait. Sebagai contoh, lihat Menggunakan label untuk memfilter akun Merchant Center.accounts.get
: Memungkinkan Anda mengambil label yang diterapkan ke satu akun Merchant Center.csses
: Memungkinkan Anda melihat dan mengelola asosiasi antara label dan domain CSS. Sebagai contoh, lihat Menerapkan label ke domain CSS.
Saat memanggil endpoint accounts
sebagai domain CSS, perhatikan persyaratan berikut:
- Domain CSS harus memberikan
cssId
, bukanmerchantId
. - 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’
}