Offer

LINT.IfChange(offer_definition) [START offer_definition] Sonraki etiket: 26

JSON gösterimi 
{
  "offerId": string,
  "entityIds": [
    string
  ],
  "addOnOfferApplicableToAllEntities": boolean,
  "offerSource": enum (OfferSource),
  "actionType": enum (ActionType),
  "offerModes": [
    enum (OfferMode)
  ],
  "offerCategory": enum (OfferCategory),
  "sourceAssignedPriority": integer,
  "offerDetails": {
    object (OfferDetails)
  },
  "offerRestrictions": {
    object (OfferRestrictions)
  },
  "coupon": {
    object (Coupon)
  },
  "paymentInstrument": {
    object (PaymentInstrument)
  },
  "subscription": {
    object (Subscription)
  },
  "terms": {
    object (Terms)
  },
  "validityPeriods": [
    {
      object (ValidityPeriod)
    }
  ],
  "offerUrl": string,
  "imageUrl": string,
  "tags": [
    enum (OfferTag)
  ],
  "brandId": string
}
Alanlar
offerId

string

Teklifin benzersiz kimliği. Zorunlu.
entityIds[]

string

Bu teklife katılan satıcıların listesi.
addOnOfferApplicableToAllEntities

boolean

Doğruysa bu teklif, toplayıcı altındaki tüm öğeler için geçerlidir. Yalnızca eklenti teklifleri için geçerlidir.
offerSource

enum (OfferSource)

Teklifler, toplayıcı, bağımsız bir satıcı veya hatta üçüncü taraf tarafından eklenti olarak sunulabilir. Zorunlu.
actionType

enum (ActionType)

Teklifi sunan hizmet. Bir offerId yalnızca bir actionType'a ait olabilir. Bir teklif birden fazla hizmet türünde paylaşılabiliyorsa her hizmet türü için benzersiz kimliklere sahip tekliflerin oluşturulması beklenir. Zorunlu.
offerModes[]

enum (OfferMode)

Tekliften yararlanma yöntemleri (ör. mağazaya gitme, rezervasyon, online). Zorunludur.
offerCategory

enum (OfferCategory)

Teklifin kategorisi. Zorunlu.
sourceAssignedPriority

integer

Kaynağın atadığı teklifin öncelik düzeyini gösteren, negatif olmayan bir tam sayı ([1-100], burada 1 en yüksek önceliği temsil eder). Aynı satıcı için birden fazla teklif olduğunda bu, tekliflerin sıralanması için bir sinyal olur. 0, önceliğin ayarlanmadığını gösterir.
offerDetails

object (OfferDetails)

İndirim, rezervasyon maliyeti gibi teklifin ayrıntıları. Zorunludur.
offerRestrictions

object (OfferRestrictions)

Teklifin nasıl kısıtlandığını (ör.abonelik/ödeme aracı gerekip gerekmediği, bu teklifin diğer tekliflerle (ve hangi türlerle) birleştirilip birleştirilemeyeceği vb.) açıklar. Zorunludur.
coupon

object (Coupon)

Kupon ayrıntıları. offerCategory: OFFER_CATEGORY_ADD_ON_COUPON_OFFER için zorunludur.
paymentInstrument

object (PaymentInstrument)

Ödeme aracının ayrıntıları offerCategory: OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER için zorunludur.
subscription

object (Subscription)

Abonelik ayrıntıları. offerCategory: OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER için zorunludur.
terms

object (Terms)

Teklifin şartları ve koşulları. Zorunlu.
validityPeriods[]

object (ValidityPeriod)

Teklifin geçerlilik süresi. Başlangıç ve bitiş zamanları, haftanın günleri vb. dahil olmak üzere teklifin geçerli olduğu zaman aralığını açıklar. Zorunludur.
offerUrl

string

Satıcının teklif sayfasının URL'si. offerCategory: OFFER_CATEGORY_BASE_OFFER için zorunludur.
imageUrl

string

Satıcının teklif resminin URL'si.
tags[]

enum (OfferTag)

Teklifle ilişkili özel etiketler. Bu, "Festival", "En Çok Puan Alan", "En Çok Rezervasyon Yapılan" gibi özel teklifleri belirlemek için kullanılır.
brandId

string

Hediye kartı anlaşmalarında, anlaşmayı sunan markayı tanımlamak için gereklidir.

OfferDetails

[START offer_details_definition] Sonraki etiket: 15

JSON gösterimi 
{
  "offerDisplayText": string,
  "maxDiscountValue": {
    object (Money)
  },
  "minSpendValue": {
    object (Money)
  },
  "bookingCost": {
    object (Money)
  },
  "bookingCostUnit": enum (FeeUnit),
  "convenienceFee": {
    object (Fee)
  },
  "bookingCostAdjustable": boolean,
  "additionalFees": [
    {
      object (AdditionalFee)
    }
  ],
  "giftCardInfo": {
    object (GiftCardInfo)
  },

  // Union field offer_specification can be only one of the following:
  "discountPercent": number,
  "discountValue": {
    object (Money)
  },
  "otherOfferDetailText": string
  // End of list of possible types for union field offer_specification.
}
Alanlar
offerDisplayText

string

Teklif sağlayıcının arama sonuçları sayfasında müşterilere göstermek istediği teklif metni. Zorunlu.
maxDiscountValue

object (Money)

Faydalanılabilecek maksimum indirim. Örneğin, 100 TL'ye kadar% 10 indirim.
minSpendValue

object (Money)

İndirimden yararlanmak için yapılması gereken minimum harcama tutarı. Örneğin, toplam fiyat 100 TL veya daha fazla olduğunda% 10 indirim.
bookingCost

object (Money)

Bu teklifi kullanmanın maliyeti. Örneğin, 15 ABD doları karşılığında masa rezerve edildiğinde son faturada 100 ABD doları indirim.
bookingCostUnit

enum (FeeUnit)

Rezervasyon maliyetinin birimi. Örneğin, kişi başına, işlem başına.
convenienceFee

object (Fee)
bookingCostAdjustable

boolean

Rezervasyon maliyetinin ayarlanabilir olup olmadığı (ör. rezervasyon maliyetinin nihai faturadan çıkarılıp çıkarılmadığı). Örneğin: Rezervasyonla akşam yemeğinde% 30 indirim. Rezervasyon maliyeti 15 ABD dolarıdır ve bu tutar son faturaya yansıtılır. Dolayısıyla nihai fatura: Toplam Harcama - %30 - 15 ABD doları
additionalFees[]

object (AdditionalFee)

Kullanıcıdan alınan ek ücretler. Örnekler: kolaylık, sevkiyata hazırlık, teslimat, paketleme, hizmet ücreti vb.
giftCardInfo

object (GiftCardInfo)

Özellikle hediye kartı fırsatlarıyla ilgili ayrıntılar.
offer_specification birleşik alanı. İndirim, toplam değerden çıkarılan bir yüzde veya sabit bir değer olabilir. Örneğin: 1. Nihai faturada% 10 indirim. 2. Siparişlerde 15 ABD doları indirim. Satıcılar, ilgili spesifikasyon alanları aracılığıyla "bir alana bir bedava" gibi özel indirimler de sunabilir. Zorunlu. offer_specification aşağıdakilerden yalnızca biri olabilir:
discountPercent

number

Faturanın indirimli yüzdesi. [0, 100] Tüm yemek için geçerli olan 1+1 veya% 50 indirim tekliflerinde (ör. açık büfe 1+1, tüm hesapta 1+1, set menüde 1+1) bu değer 50 olarak ayarlanabilir.
discountValue

object (Money)

İndirimin sabit değeri.
otherOfferDetailText

string

İndirimi açıklayan serbest biçimli metin. Belirli 1+1 teklifleri (ör. 1+1 içecek, +1 ana yemek, 1+1 seçili menü öğeleri) için bu ayrıntılar burada açıklanmalıdır.

OfferRestrictions

[START offer_restrictions_definition] Sonraki etiket: 11

JSON gösterimi 
{
  "combinableWithOtherOffers": boolean,
  "combinableOfferCategories": [
    enum (OfferCategory)
  ],
  "combinableOfferIds": [
    string
  ],
  "inclusions": [
    {
      object (OfferCondition)
    }
  ],
  "exclusions": [
    {
      object (OfferCondition)
    }
  ],
  "minGuest": integer,
  "foodOfferRestrictions": {
    object (FoodOfferRestrictions)
  },
  "specialConditions": [
    string
  ]
}
Alanlar
combinableWithOtherOffers

boolean

Bu teklifin diğer tekliflerle birleştirilip birleştirilemeyeceği. Doğru olduğunda, iş ortakları bu teklifin hangi tekliflerle birleştirilebileceğini belirtebilir. Hem combinableOfferCategories hem de combinableOfferIds ayarlanmışsa yukarıdaki koşullardan birini karşılayan tüm teklifler birleştirilebilir.
combinableOfferCategories[]

enum (OfferCategory)

Bu teklifin birleştirilebileceği teklif türlerinin listesi. Örneğin, bu teklif diğer kuponlarla birleştirilebilir. combinableWithOtherOffers doğruysa ve bu alan ayarlanmamışsa tüm türler birleştirilebilir.
combinableOfferIds[]

string

Bu teklifin birleştirilebileceği offer_id'lerin listesi. Bazı teklifler yalnızca belirli diğer offer_id'lerle (üst teklifler olarak kabul edilebilir) birleştirilebilir. combinableWithOtherOffers doğruysa ve bu alan ayarlanmamışsa tüm teklif kimlikleri birleştirilebilir.
inclusions[]

object (OfferCondition)

Teklifin geçerli olması için karşılanması gereken koşulların listesi (ör. alkolsüz içecekler, yemek).
exclusions[]

object (OfferCondition)

Teklifi geçersiz kılacak koşulların listesi (ör. açık büfe, paket teklifler ve kokteyller).
minGuest

integer

Tekliften yararlanmak için gereken minimum kişi sayısı.
foodOfferRestrictions

object (FoodOfferRestrictions)

Yemek tekliflerine özgü kısıtlamalar.
specialConditions[]

string

Bu teklif için kullanıcıya gösterilmesi gereken özel koşullar. Örnekler: "Yalnızca [bölge] içinde ödeme için geçerlidir", "Online ödemeler hariçtir"

OfferCondition

[START offer_condition_definition]

JSON gösterimi 
{
  "description": string
}
Alanlar
description

string

PaymentInstrument

[START payment_instrument_definition]

JSON gösterimi 
{
  "items": [
    {
      object (PaymentInstrumentItem)
    }
  ],
  "providerName": string
}
Alanlar
items[]

object (PaymentInstrumentItem)

Teklifi kullanmak için kullanılabilecek ödeme araçlarının listesi. Zorunlu.
providerName

string

Ödeme aracı sağlayıcısının adı. Bankacılık iş ortağı, banka adı vb. olabilir. Örneğin: American Express, HDFC, ICICI.

PaymentInstrumentItem

[START payment_instrument_item_definition]

JSON gösterimi 
{
  "type": enum (PaymentInstrumentType),
  "name": string
}
Alanlar
type

enum (PaymentInstrumentType)

Ödeme aracının türü. Zorunlu.
name

string

Ödeme aracı öğesinin adı (ör. kredi kartının adı). Örneğin: HDFC Infinia, American Express Platinum. Zorunlu.

Abonelik

[START subscription_definition]

JSON gösterimi 
{
  "name": string,
  "subscriptionAutoAdded": boolean,
  "cost": {
    object (Money)
  },
  "subscriptionDuration": string,
  "termsAndConditionsUrl": string
}
Alanlar
name

string

Aboneliğin adı. Zorunlu.
subscriptionAutoAdded

boolean

Aboneliğin, kullanıcı bu tekliften yararlandığında otomatik olarak eklenip eklenmediği
cost

object (Money)

Aboneliğin maliyeti Zorunlu.
subscriptionDuration

string (Duration format)

Aboneliğin subscription_cost fiyatıyla geçerli olduğu süre. Zorunlu.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
termsAndConditionsUrl

string

İş ortağının bu abonelikle ilgili hükümler ve koşullarının URL'si.

Şartlar

[START terms_definition]

JSON gösterimi 
{
  "url": string,
  "restrictedToCertainUsers": boolean,
  "termsAndConditions": string,
  "additionalTermsAndConditions": [
    string
  ]
}
Alanlar
url

string

İş ortağının hüküm ve koşullarının URL'si.
restrictedToCertainUsers

boolean

Teklifin belirli kullanıcılarla sınırlı olup olmadığı.
termsAndConditions

string

İş ortağı tarafından sağlanan birincil H&K metni.
additionalTermsAndConditions[]

string

İş ortağının birincil Hükümler ve Koşulları'na ek olarak geçerli olan hükümler ve koşullar.