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 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 nesnesindeki alanlar hakkında bilgi edinmek için accounts.dataSources kaynağındaki PromotionDataSource bölümüne bakın.

Mevcut veri kaynakları

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

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

Gelecekteki API çağrılarında doğrudan bunlara başvurmak için her promosyon için 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 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

Alan Değişiklikleri

Tabloda, Merchant Promotions API'deki Satıcı Promosyonları ile ilgili değişiklikler gösterilmektedir.

Referans için bir örnek görmek istiyorsanız accounts.promotions 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 özelliklerin gönderilmesi için kullanışlıdır.
Desteklenmiyor data_source Promosyon oluşturmak için mevcut bir veri kaynağı gerekir.
Desteklenmiyor attributes Promosyona özel ö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 uygulandığı öğe kimliklerinin listesi yeniden adlandırılır.
store_id store_id_inclusion 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ılır.
item_group_id item_group_id_inclusion Promosyonun uygulandığı öğe grubu kimliklerinin listesi
yeniden adlandırılır.
brand brand_inclusion Promosyonun geçerli olduğu markaların listesi
yeniden adlandırılır.
store_code store_codes_inclusion Promosyonun geçerli olduğu mağaza kodlarının 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.

amount alan adı, value'dan
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 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.
Sorunlarda daha ayrıntılı bilgiler yer alır. 
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