Satıcı Promosyonları API'sini şurada promosyon oluşturmak ve yönetmek için kullanabilirsiniz:
Google'a dokunun. İlgili içeriği oluşturmak için kullanılan
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ına Genel Bakış" bölümüne göz atın.
API.
İ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, Content API for Shopping'i Satıcı Promosyonları ile karşılaştırılmaktadır. Promosyonlarla ilgili istekler için API.
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'de tanıtım yöntemlerinin kullanılabildiği dillerin Alışveriş ve Merchant API:
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.
Content API for Shopping | Satıcı API'si | Açıklama |
---|---|---|
(desteklenmez) | custom_attributes |
Özel (satıcı tarafından sağlanan) özelliklerin listesi. Şunları yapabilirsiniz:
. bunu feed'in herhangi bir özelliğini göndermek için de . kullanabilirsiniz. . Örnek: { "name": "size type", "value": "regular" }Bu, açıkça belirtilmeyen özellikleri göndermek için yararlıdır . API tarafından gösteriliyor. |
Desteklenmiyor | data_source | Promosyon oluşturmak için mevcut bir veri kaynağı gerekir. |
Desteklenmiyor | özellikler |
Promosyona özgü özellikler, örneğin:
. long_tile, promotion_effective_timeperiod, . ve diğerleri özellik mesajının bir parçasıdır. |
item_id | item_id_inclusion |
Bir promosyonun geçerli olduğu öğe kimliklerinin listesi
yeniden adlandırıldı. |
store_id | store_id_inclusion |
Bir promosyonun geçerli olduğu mağaza kimliklerinin listesi
. olarak yeniden adlandırıldı. |
prduct_type | product_type_inclusion |
Promosyonun geçerli olduğu ürün türlerinin listesi
. olarak yeniden adlandırıldı. |
item_group_id | item_group_id_inclusion |
Promosyonun geçerli olduğu öğe grubu kodlarının listesi
. olarak yeniden adlandırıldı. |
brand | brand_inclusion |
Promosyonun geçerli olduğu markaların listesi
. olarak yeniden adlandırıldı. |
store_code | store_codes_inclusion |
Promosyonun geçerli olduğu mağaza kodlarının listesi
. olarak yeniden adlandırıldı. |
price: { object (Price) } |
price: { object (Price) } |
Fiyat'ın tanımı değişti.
Content API for Shopping'de Price (Fiyat)
Fiyat tutarı artık mikro
saniye cinsinden kaydedilir.
amount (tutar) alanının değeri, değer olarak değiştirildi.
currency alanının adı şu şekilde değişti:
|
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 bulunmaktadır. promotionStatus = { destinationStatuses = [ { reportingContext = Enum status = Enum }, ], itemLevelIssues = [ { code = String severity = Enum resolution = String reportingContext = Enum description = String detail = String documentation = String applicableCountries = [ String, ] } ] } |