Memigrasikan pengelolaan promosi

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
adalah angka desimal dalam bentuk string.

Jumlah Price sekarang dicatat dalam mikro,
dengan 1 juta mikro setara dengan
unit standar mata uang Anda.

Nama kolom amount telah diubah dari nilai menjadi
amountMicros.

Nama kolom currency telah diubah menjadi
currencyCode. Formatnya tetap seperti
ISO 4217. (Wikipedia)

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,
    ]
    }
  ]
}