Promosyon yönetimini taşı

Google'da promosyonlar oluşturmak ve yönetmek için Merchant Promosyonları API'sini kullanabilirsiniz. accounts.promotions kaynağı, Google'da sattığınız ürünler için özel teklifleri göstermenizi sağlar. Daha fazla bilgi için Satıcı Promosyonları API'sine Genel Bakış bölümüne bakın.

İstekler

İstekte bulunmak için aşağıdaki URL'yi kullanın.

POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions

Content API for Shopping'den geçiş yapın

Aşağıda, promosyonlarla ilgili istekler için Content API for Shopping ile Satıcı Promosyonları API'si karşılaştırılmıştır.

URL

Content API for Shopping'de:

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

şu şekilde olur:

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

Tanımlayıcılar

Content API for Shopping'de:

{merchantId}/promotions/{promotionId}

şu şekilde olur:

{name}

Yöntemler

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

  • Tanıtım ekle
  • Promosyonları alın
  • Tanıtımları listele

Content API for Shopping ve Merchant API'deki promosyon yöntemlerinin kullanılabilirliğinin bir karşılaştırmasını burada bulabilirsiniz:

Yöntem Content API for Shopping Satıcı API'si
ekle Evet Evet
al Evet Evet
list Evet Evet
customBatch Hayır Hayır
sil Hayır (Belirlenecek)

Kaynak Adı

Tabloda, Satıcı Promosyonları API'sindeki Promosyonlar'daki değişiklikler gösterilir.

Referans olarak bir örnek görmek için Yerel Envanter'i inceleyin.

Content API for Shopping Satıcı API'si Açıklama
(desteklenmez) custom_attributes Özel (satıcı tarafından sağlanan) özelliklerin listesi.
özelliğini, 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 gösterilmeyen
ö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,
ve diğerleri) özellik mesajının bir parçasıdır.
item_id item_id_inclusion Promosyonun geçerli olduğu öğe kimliklerinin
listesi yeniden adlandırılır.
store_id store_id_inclusion Bir promosyonun
uyguladığı mağaza kimliklerinin listesi yeniden adlandırılır.
prduct_type product_type_inclusion Promosyonun
uygulandığı ürün türlerinin listesi yeniden adlandırıldı.
item_group_id item_group_id_inclusion Bir promosyonun
uyguladığı öğe grubu kimliklerinin listesi yeniden adlandırılır.
brand brand_inclusion Promosyonun
uyguladığı markaların listesi yeniden adlandırılır.
store_code store_codes_inclusion Bir promosyonun
uyguladığı mağaza kodlarının listesi yeniden adlandırılır. 
price: {
  object (Price)
}

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

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

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

amount alanının değeri,
amountMicros olarak değiştirildi.

currency alanının 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[] desteklenmez.
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.
Sorunlarda daha ayrıntılı düzeyde ayrıntılar bulunur. 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}