REST Resource: accounts.promotions

Kaynak: Promosyon

Bir tanıtımı temsil eder. Daha ayrıntılı bilgi için aşağıdaki makaleleri inceleyin.

Veri doğrulama kontrollerini geçmek için gerekli promosyon giriş özellikleri temel olarak aşağıda tanımlanmıştır:

Promosyon girişi eklendikten ve güncellendikten sonra son promosyonun alınması birkaç dakika sürebilir.

JSON gösterimi 
{
  "name": string,
  "promotionId": string,
  "contentLanguage": string,
  "targetCountry": string,
  "redemptionChannel": [
    enum (RedemptionChannel)
  ],
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "promotionStatus": {
    object (PromotionStatus)
  },
  "versionNumber": string
}
Alanlar
name

string

Tanımlayıcı. Tanıtımın adı. Biçim: accounts/{account}/promotions/{promotion}
promotionId

string

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.
contentLanguage

string

Zorunlu. Promosyon için iki harfli ISO 639-1 dil kodu.

Promosyonlar yalnızca belirli dillerde kullanılabilir.
targetCountry

string

Zorunlu. Benzersiz tanımlayıcının 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ı
redemptionChannel[]

enum (RedemptionChannel)

Zorunlu. Promosyonun kullanım kanalı. En az bir kanal gerekiyor.
dataSource

string

Yalnızca çıkış. Promosyonun birincil veri kaynağı.
attributes

object (Attributes)

İsteğe bağlı. Promosyon özelliklerinin listesi.
customAttributes[]

object (CustomAttribute)

İ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. { "name": "size type", "value": "regular" }) göndermek için de kullanılabilir. Bu, API tarafından açıkça gösterilmeyen özelliklerin gönderilmesi için yararlıdır.
promotionStatus

object (PromotionStatus)

Yalnızca çıkış. Promosyonun durumu, veri doğrulama sorunları, yani bir promosyonla ilgili bilgiler eşzamansız olarak hesaplanır.
versionNumber

string (int64 format)

İsteğe bağlı. Promosyonun mevcut sürümünü (tazeliğini) temsil eder. 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 geçerli sürüm numarasından düşük olduğunda ekleme işlemi engellenir. Yeniden ekleme (ör. 30 gün sonra promosyonu yenileme) mevcut versionNumber ile yapılabilir.

İşlem engellenirse iptal edilen istisna uygulanır.

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 kanalıyla aynıdır.
ONLINE Kanalın internete bağlı olduğunu gösterir.

Özellikler

Özellikler.

JSON gösterimi 
{
  "productApplicability": enum (ProductApplicability),
  "offerType": enum (OfferType),
  "genericRedemptionCode": string,
  "longTitle": string,
  "couponValueType": enum (CouponValueType),
  "promotionDestinations": [
    enum (DestinationEnum)
  ],
  "itemIdInclusion": [
    string
  ],
  "brandInclusion": [
    string
  ],
  "itemGroupIdInclusion": [
    string
  ],
  "productTypeInclusion": [
    string
  ],
  "itemIdExclusion": [
    string
  ],
  "brandExclusion": [
    string
  ],
  "itemGroupIdExclusion": [
    string
  ],
  "productTypeExclusion": [
    string
  ],
  "minimumPurchaseAmount": {
    object (Price)
  },
  "minimumPurchaseQuantity": string,
  "limitQuantity": string,
  "limitValue": {
    object (Price)
  },
  "percentOff": string,
  "moneyOffAmount": {
    object (Price)
  },
  "getThisQuantityDiscounted": string,
  "freeGiftValue": {
    object (Price)
  },
  "freeGiftDescription": string,
  "freeGiftItemId": string,
  "promotionEffectiveTimePeriod": {
    object (Interval)
  },
  "promotionDisplayTimePeriod": {
    object (Interval)
  },
  "storeApplicability": enum (StoreApplicability),
  "storeCodesInclusion": [
    string
  ],
  "storeCodesExclusion": [
    string
  ],
  "promotionUrl": string
}
Alanlar
productApplicability

enum (ProductApplicability)

Zorunlu. Promosyonun tüm ürünler veya yalnızca belirli ürünler için geçerli olup olmadığı.
offerType

enum (OfferType)

Zorunlu. Promosyonun türü. Müşterilere, promosyonunuzdan yararlanmak için kupon kodu gerekip gerekmediğini belirtmek üzere bu özelliği kullanın.
genericRedemptionCode

string

İsteğe bağlı. Promosyon için genel teklif kullanma kodu. offerType alanıyla kullanılır ve minimum koşulları karşılamalıdır.
longTitle

string

Zorunlu. Promosyonun uzun başlığı.
couponValueType

enum (CouponValueType)

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.
promotionDestinations[]

enum (DestinationEnum)

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 FREE_LISTINGS, FREE_LOCAL_LISTINGS, LOCAL_INVENTORY_ADS değerlerini kullanın. Daha fazla bilgi için Promosyon hedefi başlıklı makaleyi inceleyin.
itemIdInclusion[]

string

İ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 productApplicability özelliği specific_products olarak ayarlandığında geçerlidir.
brandInclusion[]

string

İ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 productApplicability özelliği specific_products olarak ayarlandığında geçerlidir.
itemGroupIdInclusion[]

string

İ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ünler ürün uygunluğu [productApplicability] özelliği specific_products olarak ayarlandığında geçerlidir.
productTypeInclusion[]

string

İ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 productApplicability özelliği specific_products olarak ayarlandığında geçerlidir.
itemIdExclusion[]

string

İ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 promosyona uygun ürünler ürün uygunluğu productApplicability özelliği specific_products olarak ayarlandığında geçerlidir.
brandExclusion[]

string

İ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 productApplicability özelliği specific_products olarak ayarlandığında geçerlidir.
itemGroupIdExclusion[]

string

İsteğe bağlı. Öğe grubu koduna göre ürün filtresi. Ürün filtresi özellikleri yalnızca promosyona uygun ürünler ürün uygunluğu productApplicability özelliği specific_products olarak ayarlandığında geçerlidir.
productTypeExclusion[]

string

İ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 productApplicability özelliği specific_products olarak ayarlandığında geçerlidir.
minimumPurchaseAmount

object (Price)

İsteğe bağlı. Promosyon için minimum satın alma tutarı.
minimumPurchaseQuantity

string (int64 format)

İsteğe bağlı. Promosyon için minimum satın alma miktarı.
limitQuantity

string (int64 format)

İsteğe bağlı. Promosyon için maksimum satın alma miktarı.
limitValue

object (Price)

İsteğe bağlı. Promosyon için maksimum ürün fiyatı.
percentOff

string (int64 format)

İsteğe bağlı. Promosyonda sunulan indirim yüzdesi.
moneyOffAmount

object (Price)

İsteğe bağlı. Promosyonda sunulan indirim tutarı.
getThisQuantityDiscounted

string (int64 format)

İsteğe bağlı. Promosyonda indirim uygulanan öğelerin sayısı. Özellik, couponValueType buy_m_get_n_money_off veya buy_m_get_n_percent_off'ye eşit olduğunda ayarlanır.
freeGiftValue

object (Price)

İsteğe bağlı. Promosyon için hediye değeri.
freeGiftDescription

string

İsteğe bağlı. Promosyon için hediye açıklaması.
freeGiftItemId

string

İsteğe bağlı. Promosyon için hediye öğe kodu.
promotionEffectiveTimePeriod

object (Interval)

Zorunlu. TimePeriod promosyonun geçerlilik tarihlerinin temsili. Bu özellik, promosyonun bu süre zarfında online mağazanızda test edilebileceğini belirtir.
promotionDisplayTimePeriod

object (Interval)

İsteğe bağlı. TimePeriod promosyonun gösterim tarihlerinin temsili. Bu özellik, promosyonun Google.com'da ve Alışveriş reklamlarında yayınlanacağı tarihi ve zaman aralığını belirtir. Promosyon gösterim dönemi promotionDisplayTimePeriod özelliği belirtilmemişse promosyonun Google.com ve Alışveriş reklamlarında yayınlanacağı tarihi ve zaman aralığını promosyon geçerlilik dönemi promotionEffectiveTimePeriod özelliği belirler.
storeApplicability

enum (StoreApplicability)

İsteğe bağlı. Promosyonun tüm mağazalar için mi yoksa yalnızca belirli mağazalar için mi geçerli olduğu. Mağaza uygunluğu eklenmezse yerel envanter reklamı promosyonları hata verir. storeApplicability, ALL_STORES olarak ayarlanırsa ve storeCodesInclusion veya score_code_exclusion bir değere ayarlanırsa INVALID_ARGUMENT hatası atılır.
storeCodesInclusion[]

string

İsteğe bağlı. Promosyon için eklenecek mağaza kodları. Mağaza filtresi özellikleri yalnızca storeApplicability özelliği specific_stores olarak ayarlandığında geçerlidir.

Ü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.
storeCodesExclusion[]

string

İsteğe bağlı. Promosyon için hariç tutulacak mağaza kodları. Mağaza filtresi özellikleri yalnızca storeApplicability özelliği specific_stores olarak ayarlandığında geçerlidir.
promotionUrl

string

İsteğe bağlı. Satıcının sitesinde promosyonun gösterildiği sayfanın URL'si. promotionUrl dahil edilmezse yerel envanter reklamı promosyonları hata verir. URL, promosyonun geçerli ve kullanılabilir olduğunu doğrulamak için kullanılır.

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.

OfferType

Promosyonun teklif 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.

CouponValueType

Bir promosyonun kupon değeri türü.

Sıralamalar
COUPON_VALUE_TYPE_UNSPECIFIED Kupon değer türünün belirtilmemiş olduğunu gösterir.
MONEY_OFF İndirim kupon değeri türü.
PERCENT_OFF İndirim yüzdesi kupon değeri türü.
BUY_M_GET_N_MONEY_OFF M tutarında satın alın, Kupon değeri türünde N indirim kazanın. minimumPurchaseQuantity ve getThisQuantityDiscounted mevcut olmalıdır. moneyOffAmount 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ü. minimumPurchaseQuantity ve getThisQuantityDiscounted mevcut olmalıdır. percent_off_percentage öğesi de bulunmalıdır.
BUY_M_GET_MONEY_OFF M satın aldığınızda indirim kazanın. minimumPurchaseQuantity ve moneyOffAmount mevcut olmalıdır.
BUY_M_GET_PERCENT_OFF M satın aldığınızda indirim kazanın. minimumPurchaseQuantity ve percent_off_percentage mevcut olmalıdır.
FREE_GIFT Açıklamalı ücretsiz 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 Ertesi gün ücretsiz gönderim kuponu değer türü.
FREE_SHIPPING_TWO_DAY İki günde ücretsiz kargo kupon değeri türü.

DestinationEnum

Hedef değerler.

Sıralamalar
DESTINATION_ENUM_UNSPECIFIED Belirtilmedi.
SHOPPING_ADS Alışveriş reklamları.
DISPLAY_ADS Görüntülü reklamlar.
LOCAL_INVENTORY_ADS Yerel envanter reklamları.
FREE_LISTINGS Ücretsiz listelemeler.
FREE_LOCAL_LISTINGS Ücretsiz yerel ürün listelemeleri.
YOUTUBE_SHOPPING YouTube Alışveriş.
YOUTUBE_SHOPPING_CHECKOUT YouTube Alışveriş ödemesi.
YOUTUBE_AFFILIATE YouTube satış ortağı.
FREE_VEHICLE_LISTINGS Ücretsiz araç listelemeleri.
VEHICLE_ADS Araç reklamları.
CLOUD_RETAIL Cloud perakende.
LOCAL_CLOUD_RETAIL Yerel Cloud Retail.

StoreApplicability

Promosyonun geçerli olduğu mağaza kodları veya mağaza kodlarının listesi. Yalnızca yerel envanter reklamı promosyonları için.

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.

PromotionStatus

Promosyonun durumu.

JSON gösterimi 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}
Alanlar
destinationStatuses[]

object (DestinationStatus)

Yalnızca çıkış. Promosyon için amaçlanan hedefler.
itemLevelIssues[]

object (ItemLevelIssue)

Yalnızca çıkış. Promosyonla ilişkili sorunların listesi.
creationDate

string (Timestamp format)

Yalnızca çıkış. Promosyonun ISO 8601 biçiminde oluşturulduğu tarih: Tarih, saat ve ofset (ör. 2020-01-02T09:00:00+01:00 veya 2020-01-02T09:00:00Z)
lastUpdateDate

string (Timestamp format)

Yalnızca çıkış. Promosyon durumunun en son güncellendiği tarih (ISO 8601 biçiminde): Tarih, saat ve ofset (ör. 2020-01-02T09:00:00+01:00 veya 2020-01-02T09:00:00Z)

DestinationStatus

Belirtilen hedefin durumu.

JSON gösterimi 
{
  "reportingContext": enum (ReportingContextEnum),
  "status": enum (State)
}
Alanlar
reportingContext

enum (ReportingContextEnum)

Yalnızca çıkış. Promosyon hedefine ait ad.
status

enum (State)

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 durdurulmaz ve tüm incelemeler onaylanır ancak geçerlilik tarihi gelecektedir.

ItemLevelIssue

Promosyonla ilişkili sorun.

JSON gösterimi 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Alanlar
code

string

Yalnızca çıkış. Sorunun hata kodu.
severity

enum (Severity)

Yalnızca çıkış. Bu sorunun promosyonun yayınlanmasını nasıl etkilediği.
resolution

string

Yalnızca çıkış. Sorunun satıcı tarafından çözülüp çözülemeyeceği.
attribute

string

Yalnızca çıkış. Sorun tek bir özellikten kaynaklanıyorsa özelliğin adı.
reportingContext

enum (ReportingContextEnum)

Yalnızca çıkış. Sorunun geçerli olduğu hedef.
description

string

Yalnızca çıkış. İngilizce olarak kısa bir sorun açıklaması.
detail

string

Yalnızca çıkış. İngilizce olarak ayrıntılı bir sorun açıklaması.
documentation

string

Yalnızca çıkış. Bu sorunun çözülmesine yardımcı olacak bir web sayfasının URL'si.
applicableCountries[]

string

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 promosyonu doğrudan etkilemez.
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.

Yöntemler

get

 Promosyonu Merchant Center hesabınızdan alır.

insert

 Merchant Center hesabınız için bir promosyon ekler.

list

 Merchant Center hesabınızdaki promosyonları listeler.