Memigrasikan pengelolaan promosi

Anda dapat menggunakan Merchant Promotions API untuk membuat dan mengelola promosi di Google. Resource accounts.promotions memungkinkan Anda 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 signifikan adalah Content API for Shopping 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 accounts.dataSources resource, 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

ID

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
ID {MERCHANT_ID}/promotions/{PROMOTION_ID} {NAME}
Metode
  • insert
  • get
  • list
  • customBatch
  • delete
  • insert
  • get
  • list

Perubahan Kolom

Tabel ini menunjukkan perubahan untuk Promosi di Merchant Promotions API.

Untuk melihat contoh sebagai referensi, lihat accounts.promotions.

Content API for Shopping Merchant API Deskripsi
(tidak didukung) custom_attributes Daftar atribut kustom (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
ditampilkan secara eksplisit oleh API.
Tidak didukung data_source Untuk membuat promosi, Anda memerlukan sumber data yang 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 menerapkan promosi
diganti namanya.
store_id store_id_inclusion Daftar ID toko yang menerapkan promosi
diganti namanya.
product_type product_type_inclusion Daftar jenis produk yang menerapkan promosi
diganti namanya.
item_group_id item_group_id_inclusion Daftar ID kelompok item yang menerapkan 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 Harga telah berubah.

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

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

Nama kolom amount telah berubah dari value menjadi
amountMicros.

Nama kolom currency telah berubah 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 mendetail 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,
    ]
    }
  ]
}
Sebelumnya
Migrate order tracking signals
Berikutnya
Migrate conversion sources management