Promosyon yönetimini taşı

Google'da Satıcı Promosyonları 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'ye 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 ekleme işleminde veri kaynağını otomatik olarak oluşturmasıdır. Merchant API'de bu işlem gerçekleşmez. Merchant API'yi kullanarak promosyon eklemek için öncelikle promosyon veri kaynağı oluşturmanız gerekir.

accounts.dataSources kaynağındaki promotionDataSource nesnesinin alanları hakkında bilgi için PromotionDataSource sayfasını inceleyin.

Mevcut veri kaynakları

Mevcut veri kaynakları için accounts.dataSources.name değerinizi bilmiyorsanız dataSources.list yöntemini kullanarak bu değeri alın.

Alternatif olarak, accounts.promotions.get yöntemini kullanarak ve hesabınızdaki mevcut promosyonların yanıtındaki dataSource alanını inceleyerek promosyonlarınızın her birinin veri kaynağını belirleyebilirsiniz.

Gelecekteki API çağrılarında doğrudan referans vermek için her promosyonun accounts.dataSources.name değerini yerel veritabanınızda saklamanızı önemle tavsiye ederiz.

İ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 Satıcı Promosyonları 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'de şu şekilde olur:

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'de şu şekilde olur:

{NAME}

Yöntemler

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

  • Promosyon ekleme
  • Promosyonlardan yararlanın
  • Promosyonları listeleme

Content API for Shopping ve Merchant API'de kullanılabilen promosyon yöntemlerinin karşılaştırmasını 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

Alan Değişiklikleri

Tabloda, Merchant Promotions API'deki Satıcı Promosyonları için yapılan değişiklikler gösterilmektedir.

Referans olarak kullanabileceğiniz bir örnek için accounts.promotions sayfasına 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 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 Bir promosyonun uygulandığı öğe kimliklerinin listesi
yeniden adlandırıldı.
store_id store_id_inclusion Bir promosyonun geçerli olduğu mağaza kimliklerinin listesi
yeniden adlandırıldı.
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 Bir promosyonun geçerli olduğu öğe grubu kodlarının listesi
yeniden adlandırıldı.
brand brand_inclusion Bir promosyonun geçerli olduğu markaların listesi
yeniden adlandırıldı.
store_code store_codes_inclusion Bir promosyonun geçerli olduğu mağaza kodları listesi
yeniden adlandırıldı. 
price:
  {
    object (Price)
  }

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

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

Fiyat tutarı artık mikro birim cinsinden kaydedilir.
1 milyon mikro birim, para biriminizin standart birimine
eşdeğerdir.

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

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

order_limit (desteklenmez) order_limit özelliği desteklenmiyor.
shippingServiceNames[] (desteklenmez) shippingServiceNames[] desteklenmiyor.
money_budget (desteklenmez) money_budget desteklenmiyor.
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ı 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,
    ]
    }
  ]
}
Önceki
Migrate order tracking signals
Sonraki
Migrate conversion sources management