Layanan Perbandingan Belanja (CSS) dapat menempatkan iklan Shopping di Google atas nama penjual di negara tempat program CSS tersedia. Content API mengizinkan domain CSS dan kelompok CSS untuk mengatur akun terkait mereka 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 berafiliasi dengan kelompok tersebut. Layanan Content API ini menyediakan setara dengan beberapa fitur yang tersedia di halaman Perbandingan Belanja di Google Cloud Platform.
Untuk informasi selengkapnya tentang CSS, lihat Layanan Perbandingan Belanja. Untuk informasi tentang cara menggunakan label di CSS Center, lihat Gunakan 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 CSS domain.
- Domain CSS adalah akun untuk CSS itu sendiri, yang menempatkan Shopping atas nama penjual. Setiap domain CSS hanya dapat dimiliki oleh satu kelompok CSS.
- Akun Merchant Center adalah penjual yang menjadi target penempatan domain CSS Iklan Shopping. CSS dapat dikaitkan dengan beberapa jenis Penjual Akun Google Center, termasuk akun multiklien (MCA) dan penjual perorangan menggunakan akun layanan. Setiap akun Merchant Center hanya dapat dikaitkan dengan satu CSS {i>Directory<i} Untuk 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 CSS dan ke domain CSS menurut kelompok CSS.
- Label otomatis otomatis dibuat dan ditetapkan ke Merchant Center oleh CSS Center. Label otomatis tersedia untuk berbagai jenis metrik akun Anda dan dapat membantu Anda mengidentifikasi akun aktivitas akun Anda.
Untuk informasi selengkapnya tentang jenis label, termasuk label label, melihat Gunakan label akun di Comparison Shopping Service Center.
Fungsi Content API dan endpoint untuk CSS
Content API menawarkan endpoint berikut untuk CSS:
accounts.labels
: Mengizinkan Anda dapat membuat, mengambil, dan mengubah label yang akan diterapkan ke domain CSS dan Penjual Pusatkan akun. 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
: Mengizinkan Anda untuk 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. Untuk contoh, lihat Menggunakan label untuk memfilter akun Merchant Center.accounts.get
: Mengizinkan untuk mengambil label yang diterapkan ke satu akun Merchant Center.csses
: Memungkinkan Anda melihat dan mengelola pengaitan antara label dan domain CSS. Untuk contoh, lihat Menerapkan label ke domain CSS.
Saat memanggil endpoint accounts
sebagai domain CSS, perhatikan hal-hal berikut
persyaratan:
- Domain CSS harus menyediakan
cssId
-nya, bukanmerchantId
. - Domain CSS harus menyediakan parameter kueri
view=CSS
. - Domain CSS harus mencantumkan 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
jenis akun yang berbeda terpisah dan tidak dapat digunakan secara bergantian. Kepada
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 CSS
domain yang berafiliasi dengan grup tersebut, gunakan ID kelompok CSS sebagai accountId
saat
membuat label.
Contoh berikut menunjukkan cara membuat akun kunci tingkat domain
label, yang kemudian dapat diterapkan ke akun Merchant Center yang terkait dengan
{i>Directory<i} Untuk membuat label, buat permintaan POST
menggunakan URL berikut dan
isi permintaan:
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 Penjual
Akun Google yang terkait dengan domain CSS. Contoh berikut menunjukkan
cara menerapkan label akun-kunci yang dibuat di contoh sebelumnya ke label
akun Merchant Center terpenting Anda.
Untuk menerapkan label, buat permintaan POST
menggunakan URL dan minta berikut
isi:
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 label
dalam permintaan Anda untuk menampilkan hanya akun dengan label tersebut. Tujuan
contoh berikut menunjukkan cara memfilter akun Merchant Center
yang terkait dengan domain CSS, menggunakan id
(123
) dari akun kunci
label 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 CSS
yang berafiliasi dengan suatu kelompok CSS. Contoh berikut menunjukkan cara
terapkan label tingkat grup kunci-domain yang dibuat menggunakan
Metode accounts.labels.create
ke salah satu domain CSS terpenting Anda
menggunakan akun layanan. 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 minta berikut
isi:
https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
"labelIds": [‘456’] // ‘key-domains’
}