REST Resource: accounts.promotions

Kaynak: Promosyon

Bir promosyonu 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şi özellikleri genel 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 sağladığı promosyon kodudur. Promosyonların reddedilmemesi için minimum koşulları yerine getirin.

contentLanguage

string

Zorunlu. Promosyonun 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 gösterilir.

Promosyonlar yalnızca belirli ülkelerde kullanılabilir. Ücretsiz listelemeler ve Alışveriş reklamları yerel envanter reklamları.

redemptionChannel[]

enum (RedemptionChannel)

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

promotionStatus

object (PromotionStatus)

Yalnızca çıkış. Bir promosyonun durumu, veri doğrulama sorunları, yani eşzamansız olarak hesaplanan bir promosyon hakkında bilgiler.

versionNumber

string (int64 format)

İ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 geçerli sürüm numarasından düşük olduğunda ekleme işlemi engellenir. Mevcut versionNumber ile yeniden ekleme (örneğin, promosyon 30 gün sonra yenileme) işlemi gerçekleştirilebilir.

İşlem engellenirse iptal edilen istisna uygulanır.

RedemptionChannel

Tanıtım kanalı.

Sıralamalar
REDEMPTION_CHANNEL_UNSPECIFIED Kanalın belirtilmemiş olduğunu 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.

Ö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ünlere veya yalnızca belirli ürünlere uygulanabilirliği.

offerType

enum (OfferType)

Zorunlu. Promosyonun türü. Müşterilerin promosyonunuzu kullanmak için kupon koduna ihtiyacı olup olmadığını belirtmek amacıyla bu özelliği kullanın.

genericRedemptionCode

string

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

longTitle

string

Zorunlu. Promosyonun uzun başlık.

couponValueType

enum (CouponValueType)

Zorunlu. Yürüttüğünüz promosyon türünü belirtmek için 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 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 filtrelemesi. Ürün filtresi özellikleri yalnızca promosyon ürünü için uygun olan ürünler 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 promosyon ürünü için uygun olan ürünler productApplicability özelliği specific_products olarak ayarlandığında geçerlidir.

itemGroupIdInclusion[]

string

İsteğe bağlı. Promosyon için öğe grubu koduna göre ürün filtrelemesi. Ürün filtresi özellikleri yalnızca promosyon ürünü için uygun olan ürünler [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 promosyon ürünü için uygun olan ürünler 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 filtrelemesi. Ürün filtresi özellikleri yalnızca promosyon ürünü için uygun olan ürünler productApplicability özelliği specific_products olarak ayarlandığında geçerlidir.

brandExclusion[]

string

İsteğe bağlı. Promosyon için marka 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 productApplicability özelliği specific_products olarak ayarlandığında geçerlidir.

itemGroupIdExclusion[]

string

İsteğe bağlı. Öğe grubu koduna göre ürün filtrelemesi. Ürün filtresi özellikleri yalnızca promosyon ürünü için uygun olan ürünler productApplicability özelliği specific_products olarak ayarlandığında geçerlidir. promosyondan hariç tutmalısınız.

productTypeExclusion[]

string

İsteğe bağlı. Promosyon için ürün türü 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 productApplicability özelliği specific_products olarak ayarlandığında geçerlidir.

minimumPurchaseAmount

object (Price)

İsteğe bağlı. Promosyonun 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 yüzde indirimi.

moneyOffAmount

object (Price)

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

getThisQuantityDiscounted

string (int64 format)

İsteğe bağlı. Promosyondaki indirim yapılan öğelerin sayısı. Özellik, couponValueType değeri buy_m_get_n_money_off veya buy_m_get_n_percent_off 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 tarihlerini temsil eder. Bu özellik, promosyonun bu dönem boyunca online mağazanızda test edilebileceğini belirtir.

promotionDisplayTimePeriod

object (Interval)

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

storeApplicability

enum (StoreApplicability)

İ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 geçerliliği eklenmezse yerel envanter reklamı promosyonları hata verir. storeApplicability ALL_STORES olarak ve storeCodesInclusion veya score_code_exclusion bir değere ayarlanırsa INVALID_ARGUMENT hatası verilir.

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 verileri 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 eklenmezse yerel envanter reklamı promosyonları hata verir. URL, promosyonun geçerli olduğunu ve kullanılabileceğini onaylamak 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 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 fırsat türü. offerType = GENERIC_CODE olduğunda, promosyon için genel teklifi kullanma kodu gerekir.

CouponValueType

Bir promosyonun kupon değeri türü.

Sıralamalar
COUPON_VALUE_TYPE_UNSPECIFIED Kupon değer türünün belirtilmemiş olduğunu belirtir.
MONEY_OFF İndirim kuponu değer türü.
PERCENT_OFF İndirim yüzdesi 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 bulunmalıdır.
BUY_M_GET_N_PERCENT_OFF M tutarında satın alın, yüzde N indirim kuponu değeri türü kazanın. minimumPurchaseQuantity ve getThisQuantityDiscounted mevcut olmalıdır. percent_off_percentage öğesi de bulunmalıdır.
BUY_M_GET_MONEY_OFF M tutarında ürün satın alın, indirim kazanın. minimumPurchaseQuantity ve moneyOffAmount mevcut olmalıdır.
BUY_M_GET_PERCENT_OFF M tutarında ürün satın alın, indirim kazanın. minimumPurchaseQuantity ve percent_off_percentage mevcut olmalıdır.
FREE_GIFT Sadece açıklama içeren hediye.
FREE_GIFT_WITH_VALUE Parasal değeri olan hediye.
FREE_GIFT_WITH_ITEM_ID Öğe kimliği bulunan hediye.
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ün boyunca ücretsiz kargo kuponu değer türü.

DestinationEnum

Hedef değerleri.

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

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 geçerli olduğu mağaza kodları 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 ilgili 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 ISO 8601 biçiminde en son güncellendiği tarih: 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 hedefinin adı.

status

enum (State)

Yalnızca çıkış. Belirtilen hedefin durumu.

Eyalet

Promosyonun mevcut durumu.

Sıralamalar
STATE_UNSPECIFIED Bilinmeyen tanıtım durumu.
IN_REVIEW Promosyon inceleniyor.
REJECTED Tanıtım onaylanmadı.
LIVE Promosyon onaylanmış ve etkin.
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 ilgili 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 dilinde kısa bir sorun açıklaması.

detail

string

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

documentation

string

Yalnızca çıkış. Bu sorunun çözümüne yardımcı olacak bir web sayfasının URL'si.

applicableCountries[]

string

Yalnızca çıkış. Teklif için sorunun 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 Tanıtımın sıralaması düşürüldü ve büyük olasılıkla arama sonuçlarındaki performansı sınırlı olacak.
DISAPPROVED Sorun, promosyonun onaylanmamasına neden oluyor.

Yöntemler

get

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

insert

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

list

Merchant Center hesabınızdaki promosyonları listeler.