Layanan Perbandingan Belanja (CSS) dapat menempatkan iklan Shopping di Google untuk penjual di negara tempat program CSS tersedia. Content API memungkinkan domain CSS dan kelompok CSS mengatur akun terkait 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 tersebut. Layanan Content API ini memberikan layanan yang setara terprogram untuk beberapa fitur yang tersedia di Pusat Layanan Perbandingan Belanja.
Untuk 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 menjadi tujuan penempatan iklan Shopping oleh domain CSS. CSS dapat dikaitkan dengan beberapa jenis akun Merchant Center yang berbeda, 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 secara 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 Content API dan endpoint untuk CSS
Content API menawarkan endpoint berikut untuk CSS:
accounts.labels
: Memungkinkan Anda membuat, mengambil, dan mengubah label untuk diterapkan ke domain CSS dan akun 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 pengaitan 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 menyediakan
cssId
-nya, bukanmerchantId
. - Domain CSS harus menyediakan parameter kueri
view=CSS
. - Domain CSS harus memberikan ID akun Merchant Center yang terkait 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 kelompok, yang dapat diterapkan ke domain CSS yang berafiliasi dengan grup tersebut, gunakan ID kelompok CSS sebagai accountId
saat membuat label.
Contoh berikut menunjukkan cara membuat label akun kunci 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 akun-kunci yang dibuat dalam contoh sebelumnya ke salah satu akun Merchant Center Anda yang paling penting.
Untuk menerapkan label, buat permintaan POST
menggunakan URL berikut dan isi permintaan:
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 Anda untuk 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 akun, buat permintaan GET
menggunakan URL berikut:
https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123
Tidak ada isi permintaan yang 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 domain-kunci yang dibuat menggunakan metode accounts.labels.create
ke salah satu akun domain CSS 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
-nya.
Untuk menerapkan label, buat permintaan POST
menggunakan URL berikut dan isi permintaan:
https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
"labelIds": [‘456’] // ‘key-domains’
}