Memigrasikan pengelolaan promosi

Anda dapat menggunakan Merchant Promotion API untuk membuat dan mengelola promosi di Google. Tujuan accounts.promotions memungkinkan Anda menampilkan penawaran spesial untuk produk yang Anda jual di Google. Untuk informasi selengkapnya, lihat Ringkasan Promosi Merchant Google Cloud Platform.

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 Promosi Merchant 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

Pengenal

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 ini perbandingan ketersediaan metode promosi di Content API untuk 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 Lokal Inventaris.

Content API for Shopping API Penjual Deskripsi
(tidak didukung) custom_attributes Daftar atribut khusus (disediakan penjual). Anda dapat
gunakan juga untuk mengirimkan atribut feed
spesifikasi dalam bentuk generiknya.
Contoh: 
{
  "name": "size type", "value": "regular"
}
Hal ini berguna untuk mengirimkan atribut yang secara tidak eksplisit
yang 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, adalah bagian dari pesan atribut.
item_id item_id_inclusion Daftar ID item yang diterapkan oleh promosi
menjadi diganti namanya.
store_id store_id_inclusion Daftar ID toko yang menerapkan promosi
diganti namanya.
prduct_type product_type_inclusion Daftar jenis produk yang diterapkan dengan promosi
diganti namanya.
item_group_id item_group_id_inclusion Daftar ID kelompok item yang diterapkan dengan promosi
diganti namanya.
brand brand_inclusion Daftar merek yang menerapkan promosi
diganti namanya.
store_code store_codes_inclusion Daftar kode toko yang menerapkan promosi
diganti namanya. 
price: {
  object (Price)
}

price: {
  object (Price)
}
Definisi Price telah berubah.

Di Content API for Shopping, Price
adalah bilangan desimal dalam bentuk {i>string<i}.

Jumlah Price sekarang dicatat dalam mikro,
di mana 1 juta mikro setara dengan jumlah
dan unit standar.

Nama kolom amount telah diubah dari nilai menjadi
amountMicros.

Nama kolom currency telah berubah menjadi
currencyCode. Formatnya tetap sebagai
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,
    ]
    }
  ]
}