Anda dapat menggunakan Merchant Promotion API untuk membuat dan mengelola promosi di Google. Dengan resource accounts.promotions memungkinkan Anda menampilkan penawaran spesial untuk produk yang Anda jual di Google. Untuk informasi selengkapnya, lihat Ringkasan Merchant Promotion API.
Permintaan
Untuk membuat permintaan, gunakan URL berikut.
POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions
Bermigrasi dari Content API for Shopping
Gambar berikut membandingkan Content API for Shopping dengan Merchant Promotion API untuk permintaan terkait promosi.
URL
Di Content API for Shopping:
https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions
di Merchant API menjadi:
https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions
ID
Di Content API for Shopping:
{merchantId}/promotions/{promotionId}
di Merchant API menjadi:
{name}
Metode
Merchant API mendukung metode berikut untuk promosi:
- Sisipkan promosi
- Dapatkan promosi
- Menampilkan daftar promosi
Berikut adalah perbandingan ketersediaan metode promosi di Content API for Shopping dan Merchant API:
Metode | Content API for Shopping | API Penjual |
---|---|---|
sisipkan | Ya | Ya |
dapatkan | Ya | Ya |
list | Ya | Ya |
customBatch | Tidak | Tidak |
hapus | Tidak | (Akan ditentukan) |
Nama Resource
Tabel ini menunjukkan perubahan pada Promosi di Merchant Promotion API.
Untuk melihat contoh referensi, lihat Inventaris Lokal.
Content API for Shopping | API Penjual | Deskripsi |
---|---|---|
(tidak didukung) | custom_attributes |
Daftar atribut khusus (disediakan penjual). Anda juga dapat
menggunakannya untuk mengirimkan atribut spesifikasi feed dalam bentuk generiknya. Misalnya: { "name": "size type", "value": "regular" }Ini berguna untuk mengirimkan atribut yang tidak secara eksplisit diekspos oleh API. |
Tidak didukung | data_source | Untuk membuat promosi, Anda harus memiliki sumber data yang ada. |
Tidak didukung | atribut |
Atribut khusus promosi, misalnya,
long_tile, long_tile, dan lainnya, merupakan bagian dari pesan atribut. |
item_id | item_id_inclusion |
Daftar ID item tempat promosi diterapkan
diganti namanya. |
store_id | store_id_inclusion |
Daftar ID toko tempat promosi diterapkan
diganti namanya. |
prduct_type | product_type_inclusion |
Daftar jenis produk tempat promosi diterapkan
diganti namanya. |
item_group_id | item_group_id_inclusion |
Daftar ID kelompok item tempat promosi diterapkan
diganti namanya. |
brand | brand_inclusion |
Daftar merek tempat promosi diterapkan
diganti namanya. |
store_code | store_codes_inclusion |
Daftar kode toko tempat promosi diterapkan
diganti namanya. |
price: { object (Price) } |
price: { object (Price) } |
Definisi Price telah berubah.
Di Content API for Shopping, Price
Jumlah Price sekarang dicatat dalam mikro,
Nama kolom amount telah diubah dari nilai menjadi
Nama kolom currency telah diubah menjadi
|
order_limit | (tidak didukung) | Atribut order_limit tidak didukung. |
shippingServiceNames[] | (tidak didukung) | shippingServiceNames[] tidak didukung. |
money_budget | (tidak didukung) | money_budget tidak didukung. |
promotion_destination_ids | promotion_destinations | promotionDestinationIds diganti namanya. |
Status Promosi
{ "destinationStatuses": [ { "destination": string, "status": enum (State) } ], "promotionIssue": [ { "code": string, "detail": string } ], "creationDate": string, "lastUpdateDate": string } |
Status Promosi telah berubah.
Detail yang lebih terperinci tersedia dalam masalah. promotionStatus = { destinationStatuses = [ { reportingContext = Enum status = Enum }, ], itemLevelIssues = [ { code = String severity = Enum resolution = String reportingContext = Enum description = String detail = String documentation = String applicableCountries = [ String, ] } ] } |