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
Fiyat tutarı artık mikro cinsinden (
amount alanının değeri,
currency alanının adı |
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, ] } ] } |