Dizin
PromotionsService
(arayüz)Attributes
(message)CouponValueType
(enum)GetPromotionRequest
(message)InsertPromotionRequest
(message)ListPromotionsRequest
(message)ListPromotionsResponse
(message)OfferType
(enum)ProductApplicability
(enum)Promotion
(message)PromotionStatus
(message)PromotionStatus.DestinationStatus
(message)PromotionStatus.DestinationStatus.State
(enum)PromotionStatus.ItemLevelIssue
(message)PromotionStatus.ItemLevelIssue.Severity
(enum)RedemptionChannel
(enum)StoreApplicability
(enum)
PromotionsService
Ürünlerin tanıtımlarını yönetmek için kullanılan hizmet.
GetPromotion |
---|
Promosyonu Merchant Center hesabınızdan alır. Bir promosyon girişi ekledikten veya güncelledikten sonra güncellenen promosyonun alınabilmesi birkaç dakika sürebilir.
|
InsertPromotion |
---|
Merchant Center hesabınız için bir promosyon ekler. Promosyon zaten mevcutsa promosyon güncellenir.
|
ListPromotions |
---|
Merchant Center hesabınızdaki promosyonları listeler. Yanıt, Bir promosyon eklendikten veya güncellendikten sonra, güncellenmiş ve işlenmiş promosyonun alınabilmesi birkaç dakika sürebilir.
|
Özellikler
Özellikler.
Alanlar | |
---|---|
product_ |
Zorunlu. Promosyonun tüm ürünler veya yalnızca belirli ürünler için geçerli olup olmadığı. |
offer_ |
Zorunlu. Promosyonun türü. Müşterilerin promosyonunuzu kullanmak için kupon koduna ihtiyacı olup olmadığını belirtmek amacıyla bu özelliği kullanın. |
generic_ |
İsteğe bağlı. Promosyon için genel teklif kullanma kodu. |
long_ |
Zorunlu. Promosyonun uzun başlığı. |
coupon_ |
Zorunlu. Yürüttüğünüz promosyonun türünü gösteren kupon değeri türü özelliği. Seçilen kupon değerinin türüne bağlı olarak bazı özellikler gereklidir. |
promotion_ |
Zorunlu. Promosyonun geçerli olduğu hedeflerin listesi. Veri kaynağınıza desteklenen bir değer ekleyerek hedef belirtmezseniz promosyonunuz varsayılan olarak Alışveriş reklamlarında ve ücretsiz listelemelerde gösterilir. Daha önce ürünleriniz için hedef olarak şu değerleri göndermiş olabilirsiniz: Shopping Actions, Google platformları, Yerel Google platformları. Bu değerleri temsil etmek için |
item_ |
İsteğe bağlı. Promosyon için öğe kimliğine göre ürün filtresi. Ürün filtresi özellikleri yalnızca promosyona uygun ürünler ürün uygunluğu |
brand_ |
İsteğe bağlı. Promosyon için markaya göre ürün filtresi. Ürün filtresi özellikleri yalnızca promosyona uygun ürünler ürün uygunluğu |
item_ |
İsteğe bağlı. Promosyon için öğe grubu kimliğine göre ürün filtresi. Ürün filtresi özellikleri yalnızca promosyona uygun ürünlerde ürün uygunluğu [product_applicability] özelliğinin specific_products olarak ayarlandığı durumlarda kullanılabilir. |
product_ |
İsteğe bağlı. Promosyon için ürün türüne göre ürün filtresi. Ürün filtresi özellikleri yalnızca promosyona uygun ürünler ürün uygunluğu |
item_ |
İsteğe bağlı. Promosyon için öğe kimliği hariç tutma ölçütüne göre ürün filtresi. Ürün filtresi özellikleri yalnızca promosyon ürünü için uygun olan ürünler |
brand_ |
İsteğe bağlı. Promosyon için marka hariç tutma özelliğine göre ürün filtresi. Ürün filtresi özellikleri yalnızca promosyona uygun ürünler ürün uygunluğu |
item_ |
İsteğe bağlı. Öğe grubu koduna göre ürün filtresi. Ürün filtresi özellikleri yalnızca promosyon ürünü için uygun olan ürünler |
product_ |
İsteğe bağlı. Promosyon için ürün türü hariç tutma özelliğine göre ürün filtresi. Ürün filtresi özellikleri yalnızca promosyona uygun ürünler ürün uygunluğu |
minimum_ |
İsteğe bağlı. Promosyon için minimum satın alma tutarı. |
minimum_ |
İsteğe bağlı. Promosyon için minimum satın alma miktarı. |
limit_ |
İsteğe bağlı. Promosyon için maksimum satın alma miktarı. |
limit_ |
İsteğe bağlı. Promosyon için maksimum ürün fiyatı. |
percent_ |
İsteğe bağlı. Promosyonda sunulan indirim yüzdesi. |
money_ |
İsteğe bağlı. Promosyonda sunulan indirim tutarı. |
get_ |
İsteğe bağlı. Promosyonda indirim uygulanan öğelerin sayısı. Özellik, |
free_ |
İsteğe bağlı. Promosyon için hediye değeri. |
free_ |
İsteğe bağlı. Promosyon için hediye açıklaması. |
free_ |
İsteğe bağlı. Promosyon için hediye öğe kodu. |
promotion_ |
Zorunlu. |
promotion_ |
İsteğe bağlı. |
store_ |
İsteğe bağlı. Promosyonun tüm mağazalar mı yoksa yalnızca belirtilen mağazalar için mi geçerli olduğu. Mağaza uygunluğu eklenmezse yerel envanter reklamı promosyonları hata verir. |
store_ |
İsteğe bağlı. Promosyon için eklenecek mağaza kodları. Mağaza filtresi özellikleri yalnızca Ürünün satıldığı fiziksel mağazanın mağaza kodu (İşletme Profilinizdeki mağaza kimliği). Daha fazla bilgi için Yerel ürün envanteri veri spesifikasyonuna bakın. |
store_ |
İsteğe bağlı. Promosyon için hariç tutulacak mağaza kodları. Mağaza filtresi özellikleri yalnızca |
promotion_ |
İsteğe bağlı. Satıcının sitesinde promosyonun gösterildiği sayfanın URL'si. |
CouponValueType
Bir promosyonun kupon değeri türü.
Sıralamalar | |
---|---|
COUPON_VALUE_TYPE_UNSPECIFIED |
Kupon değeri türünün belirtilmediğini gösterir. |
MONEY_OFF |
İndirim kuponu değer türü. |
PERCENT_OFF |
İndirim yüzdesi kupon değeri türü. |
BUY_M_GET_N_MONEY_OFF |
M satın aldığınızda N indirim kazanın kupon değeri türü. minimum_purchase_quantity ve get_this_quantity_discounted mevcut olmalıdır. money_off_amount da mevcut olmalıdır. |
BUY_M_GET_N_PERCENT_OFF |
M satın aldığınızda yüzde N indirim kazanın kupon değeri türü. minimum_purchase_quantity ve get_this_quantity_discounted mevcut olmalıdır. percent_off_percentage da mevcut olmalıdır. |
BUY_M_GET_MONEY_OFF |
M satın aldığınızda indirim kazanın. minimum_purchase_quantity ve money_off_amount mevcut olmalıdır. |
BUY_M_GET_PERCENT_OFF |
M miktarda satın alın, indirim kazanın. minimum_purchase_quantity ve percent_off_percentage bulunmalıdır. |
FREE_GIFT |
Sadece açıklama içeren hediye. |
FREE_GIFT_WITH_VALUE |
Parasal değeri olan hediye. |
FREE_GIFT_WITH_ITEM_ID |
Hediye öğe kodu. |
FREE_SHIPPING_STANDARD |
Standart ücretsiz kargo kupon değeri türü. |
FREE_SHIPPING_OVERNIGHT |
Sonraki iş günü teslim ücretsiz kargo kupon değeri türü. |
FREE_SHIPPING_TWO_DAY |
İki gün boyunca ücretsiz kargo kuponu değer türü. |
GetPromotionRequest
GetPromotion
yöntemi için istek mesajı.
Alanlar | |
---|---|
name |
Zorunlu. Alınacak promosyonun adı. Biçim: |
InsertPromotionRequest
InsertPromotion
yöntemi için istek mesajı.
Alanlar | |
---|---|
parent |
Zorunlu. Promosyonun ekleneceği hesap. Biçim: accounts/{account} |
promotion |
Zorunlu. Eklenecek promosyon. |
data_ |
Zorunlu. Promosyon biçiminin veri kaynağı: |
ListPromotionsRequest
ListPromotions
yöntemi için istek mesajı.
Alanlar | |
---|---|
parent |
Zorunlu. İşlenen promosyonların listeleneceği hesap. Biçim: |
page_ |
Yalnızca çıkış. Döndürülecek maksimum promosyon sayısı. Hizmet bu değerden daha az sonuç döndürebilir. Maksimum değer 250'dir. 250'den yüksek değerler 250'ye zorlanacaktır. Belirtilmemesi durumunda maksimum promosyon sayısı döndürülür. |
page_ |
Yalnızca çıkış. Önceki bir Sayfalandırma yapılırken |
ListPromotionsResponse
ListPromotions
yöntemi için yanıt mesajı.
Alanlar | |
---|---|
promotions[] |
Belirtilen hesaptaki işlenmiş promosyonlar. |
next_ |
Sonraki sayfayı almak için |
OfferType
Promosyonun fırsat türü.
Sıralamalar | |
---|---|
OFFER_TYPE_UNSPECIFIED |
Bilinmeyen teklif türü. |
NO_CODE |
Kod içermeyen teklif türü. |
GENERIC_CODE |
Kod içeren teklif türü. offerType = GENERIC_CODE olduğunda promosyon için genel teklif kullanma kodu gereklidir. |
ProductApplicability
Promosyonun geçerli olduğu ürün veya ürün listesi.
Sıralamalar | |
---|---|
PRODUCT_APPLICABILITY_UNSPECIFIED |
Promosyonun hangi ürünler için geçerli olduğu bilinmiyor. |
ALL_PRODUCTS |
Tüm ürünler için geçerlidir. |
SPECIFIC_PRODUCTS |
Yalnızca tek bir ürün veya ürün listesi için geçerlidir. |
Tanıtım
Bir promosyonu temsil eder. Daha fazla bilgi için aşağıdaki makaleleri inceleyin.
Veri doğrulama kontrollerini geçmek için gerekli promosyon girişi özellikleri genel olarak aşağıda tanımlanmıştır:
Bir promosyon girişi ekledikten ve güncelledikten sonra nihai promosyonun alınabilmesi birkaç dakika sürebilir.
Alanlar | |
---|---|
name |
Tanımlayıcı. Tanıtımın adı. Biçim: |
promotion_ |
Zorunlu. Kullanıcı, promosyonu benzersiz şekilde tanımlamak için promosyon kimliği sağladı. Promosyonların reddedilmesini önlemek için minimum koşulları yerine getirin. |
content_ |
Zorunlu. Promosyon için iki harfli ISO 639-1 dil kodu. Promosyonlar yalnızca belirli dillerde kullanılabilir. |
target_ |
Zorunlu. Benzersiz tanımlayıcının bir parçası olarak kullanılan hedef ülke. CLDR bölge kodu olarak temsil edilir. Promosyonlar yalnızca belirli ülkelerde kullanılabilir. Ücretsiz listelemeler ve Alışveriş reklamları Yerel envanter reklamları |
redemption_ |
Zorunlu. Promosyonun kullanım kanalı. En az bir kanal gerekiyor. |
data_ |
Yalnızca çıkış. Promosyonun birincil veri kaynağı. |
attributes |
İsteğe bağlı. Promosyon özelliklerinin listesi. |
custom_ |
İsteğe bağlı. Özel (satıcı tarafından sağlanan) özelliklerin listesi. Ayrıca, veri spesifikasyonunun herhangi bir özelliğini genel biçiminde (ör. |
promotion_ |
Yalnızca çıkış. Promosyonun durumu, veri doğrulama sorunları, yani bir promosyonla ilgili bilgiler eşzamansız olarak hesaplanır. |
version_ |
İsteğe bağlı. Promosyonun mevcut sürümünü (güncelliğini) temsil eder. Bu sürüm, aynı anda birden fazla güncelleme yapıldığında doğru sırayı korumak için kullanılabilir. Ayarlanırsa sürüm numarası mevcut promosyonun mevcut sürüm numarasından düşük olduğunda kampanyanın eklenmesi engellenir. Yeniden ekleme (ör. 30 gün sonra promosyonu yenileme) mevcut İşlem engellenirse iptal edilen istisna atılır. |
PromotionStatus
Promosyonun durumu.
Alanlar | |
---|---|
destination_ |
Yalnızca çıkış. Promosyon için amaçlanan hedefler. |
item_ |
Yalnızca çıkış. Promosyonla ilişkili sorunların listesi. |
creation_ |
Yalnızca çıkış. Promosyonun oluşturulduğu tarih (ISO 8601 biçiminde): Tarih, saat ve ofset (ör. |
last_ |
Yalnızca çıkış. Promosyon durumunun en son güncellendiği tarih (ISO 8601 biçiminde): Tarih, saat ve ofset (ör. |
DestinationStatus
Belirtilen hedefin durumu.
Alanlar | |
---|---|
reporting_ |
Yalnızca çıkış. Promosyon hedefine ait ad. |
status |
Yalnızca çıkış. Belirtilen hedefin durumu. |
Eyalet
Promosyonun mevcut durumu.
Sıralamalar | |
---|---|
STATE_UNSPECIFIED |
Bilinmeyen promosyon durumu. |
IN_REVIEW |
Promosyon inceleniyor. |
REJECTED |
Promosyon onaylanmadı. |
LIVE |
Promosyon onaylanmış ve etkin olmalıdır. |
STOPPED |
Promosyon satıcı tarafından durduruldu. |
EXPIRED |
Promosyon artık etkin değil. |
PENDING |
Promosyon durdurulmamış ve tüm incelemeler onaylanmış ancak etkin tarih gelecekte. |
ItemLevelIssue
Promosyonla ilişkili sorun.
Alanlar | |
---|---|
code |
Yalnızca çıkış. Sorunun hata kodu. |
severity |
Yalnızca çıkış. Bu sorunun promosyonun yayınlanmasını nasıl etkilediği. |
resolution |
Yalnızca çıkış. Sorunun satıcı tarafından çözülüp çözülemeyeceği. |
attribute |
Yalnızca çıkış. Sorun tek bir özellikten kaynaklanıyorsa özelliğin adı. |
reporting_ |
Yalnızca çıkış. Sorunun geçerli olduğu hedef. |
description |
Yalnızca çıkış. İngilizce olarak kısa bir sorun açıklaması. |
detail |
Yalnızca çıkış. İngilizce olarak ayrıntılı bir sorun açıklaması. |
documentation |
Yalnızca çıkış. Bu sorunun çözülmesine yardımcı olacak bir web sayfasının URL'si. |
applicable_ |
Yalnızca çıkış. Sorunun teklif için geçerli olduğu ülke kodlarının (ISO 3166-1 alpha-2) listesi. |
Önem derecesi
Sorunun önem derecesi.
Sıralamalar | |
---|---|
SEVERITY_UNSPECIFIED |
Belirtilmedi. |
NOT_IMPACTED |
Bu sorun bir uyarı niteliğindedir ve tanıtım üzerinde doğrudan bir etkisi yoktur. |
DEMOTED |
Promosyon, sıralaması düşürülür ve büyük olasılıkla arama sonuçlarında sınırlı performans gösterir. |
DISAPPROVED |
Sorun nedeniyle promosyon onaylanmıyor. |
RedemptionChannel
Promosyonun kanalı.
Sıralamalar | |
---|---|
REDEMPTION_CHANNEL_UNSPECIFIED |
Kanalın belirtilmediğini gösterir. |
IN_STORE |
Kanalın mağazada olduğunu gösterir. Bu, products için kullanılan local kanalla aynı. |
ONLINE |
Kanalın internete bağlı olduğunu gösterir. |
StoreApplicability
Promosyonun geçerli olduğu mağaza kodları veya mağaza kodlarının listesi. Yalnızca yerel envanter reklamı promosyonları için geçerlidir.
Sıralamalar | |
---|---|
STORE_APPLICABILITY_UNSPECIFIED |
Promosyonun hangi mağaza kodları için geçerli olduğu bilinmiyor. |
ALL_STORES |
Promosyon tüm mağazalar için geçerlidir. |
SPECIFIC_STORES |
Promosyon yalnızca belirtilen mağazalar için geçerlidir. |