Memigrasikan pengelolaan promosi

Anda dapat menggunakan Merchant Promotions API untuk membuat dan mengelola promosi di Google. Dengan resource accounts.promotions, Anda dapat menampilkan penawaran khusus untuk produk yang Anda jual di Google. Untuk mengetahui informasi selengkapnya, lihat Ringkasan Merchant Promotions API.

Ringkasan perubahan dari Content API for Shopping ke Merchant API

Perbedaan yang signifikan adalah Content API for Shopping secara otomatis membuat sumber data saat penyisipan promosi pertama, yang tidak terjadi dengan Merchant API. Untuk menyisipkan promosi menggunakan Merchant API, Anda harus membuat sumber data promosi terlebih dahulu. Untuk mengetahui informasi tentang kolom dalam objek promotionDataSource di resource accounts.dataSources, lihat PromotionDataSource.

Permintaan

Untuk membuat permintaan, gunakan URL berikut.

POST https://merchantapi.googleapis.com/promotions/v1/{ACCOUNT_NAME}/promotions

Bermigrasi dari Content API for Shopping

Berikut perbandingan Content API for Shopping dengan Merchant Promotions API untuk permintaan terkait promosi.

URL

Di Content API for Shopping:

https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions

di Merchant API menjadi:

https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions

Pengenal

Di Content API for Shopping:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

di Merchant API menjadi:

{NAME}

Metode

Merchant API mendukung metode berikut untuk promosi:

  • Menyisipkan promosi
  • Mendapatkan promosi
  • Mencantumkan promosi

Berikut perbandingan ketersediaan metode promosi di Content API for Shopping dan Merchant API:

Fitur Content API for Shopping Merchant API
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions
Pengenal (ID) {MERCHANT_ID}/promotions/{PROMOTION_ID} {NAME}
Metode
  • insert
  • get
  • list
  • customBatch
  • delete
  • insert
  • get
  • list
  • delete

Perubahan Kolom

Tabel ini menunjukkan perubahan untuk Promosi di Merchant Promotions API.

Untuk melihat contoh sebagai referensi, lihat Inventaris Lokal.

Content API for Shopping Merchant API Deskripsi
(tidak didukung) custom_attributes Daftar atribut kustom (yang disediakan pengguna). Anda juga dapat
menggunakannya untuk mengirimkan atribut apa pun dari spesifikasi
feed dalam bentuk umumnya.
Contoh: 
{
  "name": "size type", "value": "regular"
}
Hal ini berguna untuk mengirimkan atribut yang tidak secara eksplisit
diekspos oleh API.
Tidak didukung data_source Untuk membuat promosi, Anda memerlukan sumber data yang sudah ada.
Tidak didukung attributes Atribut khusus promosi, misalnya,
long_tile, promotion_effective_timeperiod,
dan lainnya, adalah bagian dari pesan atribut.
item_id item_id_inclusion Daftar ID item yang diterapkan promosi
diganti namanya.
store_id store_id_inclusion Daftar ID toko tempat promosi berlaku
diganti namanya.
product_type product_type_inclusion Daftar jenis produk yang menerapkan
promosi diganti namanya.
item_group_id item_group_id_inclusion Daftar ID grup item yang berlaku untuk promosi
diganti namanya.
brand brand_inclusion Daftar merek yang menerapkan promosi
diubah namanya.
store_code store_codes_inclusion Daftar kode toko tempat promosi berlaku
diganti namanya. 
price:
  {
    object (Price)
  }

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

Di Content API for Shopping, Harga
adalah bilangan desimal dalam bentuk string.

Jumlah Harga kini dicatat dalam mikro,
dengan 1 juta mikro setara dengan satuan standar
mata uang Anda.

Nama kolom amount telah berubah dari value menjadi
amountMicros.

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