Promosyon yönetimini taşı

Google'da promosyon oluşturmak ve yönetmek için Merchant Promotions API'yi kullanabilirsiniz. accounts.promotions kaynağı, Google'da sattığınız ürünlerle ilgili özel teklifleri sergilemenize olanak tanır. Daha fazla bilgi için Satıcı Promosyonları API'sine Genel Bakış başlıklı makaleyi inceleyin.

Content API for Shopping'den Merchant API'ye geçişle ilgili değişikliklere genel bakış

Önemli bir fark, Content API for Shopping'in ilk promosyon eklenmesinde veri kaynağını otomatik olarak oluşturmasıdır. Bu durum Merchant API'de geçerli değildir. Merchant API'yi kullanarak promosyon eklemek için öncelikle promosyon veri kaynağı oluşturmanız gerekir. promotionDataSource kaynağındaki accounts.dataSources nesnesindeki alanlar hakkında bilgi için PromotionDataSource başlıklı makaleyi inceleyin.

İstekler

İstek göndermek için aşağıdaki URL'yi kullanın.

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

Content API for Shopping'den geçiş yapma

Aşağıda, promosyonlarla ilgili istekler için Content API for Shopping ile Merchant Promotions API karşılaştırılmaktadır.

URL

Content API for Shopping'de:

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

Merchant API'deki

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

Tanımlayıcılar

Content API for Shopping'de:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

Merchant API'deki

{NAME}

Yöntemler

Merchant API, promosyonlar için aşağıdaki yöntemleri destekler:

  • Promosyon ekleme
  • Promosyonlardan yararlanma
  • Promosyonları listeleme

Content API for Shopping ve Merchant API'de promosyon yöntemlerinin kullanılabilirliğiyle ilgili karşılaştırmayı aşağıda bulabilirsiniz:

Özellik 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
Tanımlayıcılar {MERCHANT_ID}/promotions/{PROMOTION_ID} {NAME}
Yöntemler
  • insert
  • get
  • list
  • customBatch
  • delete
  • insert
  • get
  • list
  • delete

Alan Değişiklikleri

Tabloda, Merchant Promotions API'deki promosyonlarla ilgili değişiklikler gösterilmektedir.

Referans için bir örnek görmek isterseniz Yerel Envanter bölümüne bakın.

Content API for Shopping Merchant API Açıklama
(desteklenmez) custom_attributes Özel (kullanıcı tarafından sağlanan) özelliklerin listesi. Ayrıca, feed spesifikasyonunun herhangi bir özelliğini genel biçiminde göndermek için de kullanabilirsiniz.


Örneğin: 
{
  "name": "size type", "value": "regular"
}
Bu, API tarafından açıkça
sunulmayan özellikleri göndermek için kullanışlıdır.
Desteklenmiyor data_source Promosyon oluşturmak için mevcut bir veri kaynağı gerekir.
Desteklenmiyor özellikler Promosyona özgü özellikler (ör. long_tile, promotion_effective_timeperiod vb.) özellik mesajının bir parçasıdır.
item_id item_id_inclusion Promosyonun uygulandığı öğe kimliklerinin listesi yeniden adlandırılır.
store_id store_id_inclusion Bir promosyonun geçerli olduğu mağaza kimliklerinin listesi yeniden adlandırılır.
product_type product_type_inclusion Bir promosyonun geçerli olduğu ürün türlerinin listesi yeniden adlandırıldı.
item_group_id item_group_id_inclusion Promosyonun uygulandığı öğe grubu kimliklerinin listesi yeniden adlandırıldı.
brand brand_inclusion Promosyonun uygulandığı markaların listesi
yeniden adlandırılır.
store_code store_codes_inclusion Bir promosyonun geçerli olduğu mağaza kodları listesi yeniden adlandırılır. 
price:
  {
    object (Price)
  }

price:
  {
    object (Price)
  }
Fiyat tanımı değişti.

Content API for Shopping'de Price
dize biçiminde bir ondalık sayıydı.

Fiyat tutarı artık mikro birim cinsinden kaydediliyor.
1 milyon mikro birim, para biriminizin
standart birimine eşittir.

Tutar alan adı değerden
amountMicros olarak değiştirildi.

Para birimi alan adı,
currencyCode olarak değiştirildi. Biçim
ISO 4217 olarak kalır. (Vikipedi)

order_limit (desteklenmez) order_limit özelliği desteklenmez.
shippingServiceNames[] (desteklenmez) shippingServiceNames[] desteklenmiyor.
money_budget (desteklenmez) money_budget desteklenmez.
promotion_destination_ids promotion_destinations promotionDestinationIds yeniden adlandırıldı.
Promosyon durumu 
{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}
Promosyon durumu değişti.
Sorunlarla ilgili daha ayrıntılı bilgiler mevcuttur. 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}