Offer

LINT.IfChange(offer_definition) [START offer_definition] Next tag: 26

JSON के काेड में दिखाना
{
  "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
}
फ़ील्ड
offerId

string

ऑफ़र का यूनीक आईडी. ज़रूरी है.

entityIds[]

string

इस ऑफ़र में हिस्सा लेने वाले कारोबारियों या कंपनियों की सूची.

addOnOfferApplicableToAllEntities

boolean

अगर यह वैल्यू 'सही है' पर सेट है, तो इसका मतलब है कि यह ऑफ़र, एग्रीगेटर के तहत आने वाली सभी इकाइयों पर लागू होता है. यह सिर्फ़ ऐड-ऑन ऑफ़र पर लागू होता है.

offerSource

enum (OfferSource)

ऑफ़र, एग्रीगेटर, कोई कारोबारी या कंपनी या ऐड-ऑन के तौर पर कोई थर्ड पार्टी दे सकती है. ज़रूरी है.

actionType

enum (ActionType)

वह सेवा जो ऑफ़र दे रही है. एक offerId सिर्फ़ एक actionType से जुड़ा हो सकता है. अगर किसी ऑफ़र को एक से ज़्यादा तरह की सेवाओं के लिए शेयर किया जा सकता है, तो हर सेवा के लिए यूनीक आईडी वाले डुप्लीकेट ऑफ़र बनाए जाने चाहिए. ज़रूरी है.

offerModes[]

enum (OfferMode)

ऑफ़र का फ़ायदा पाने के तरीके - स्टोर पर जाकर, बुकिंग करके, ऑनलाइन वगैरह. यह ज़रूरी है.

offerCategory

enum (OfferCategory)

ऑफ़र की कैटगरी. ज़रूरी है.

sourceAssignedPriority

integer

यह एक नॉन-नेगेटिव पूर्णांक ([1-100], जहां 1 सबसे ज़्यादा प्राथमिकता को दिखाता है) होता है. इससे सोर्स से असाइन किए गए ऑफ़र की प्राथमिकता के लेवल का पता चलता है. जब एक ही कारोबारी या कंपनी के लिए कई ऑफ़र उपलब्ध होते हैं, तो यह ऑफ़र को रैंक करने के लिए एक सिग्नल होगा. 0 का मतलब है कि प्राथमिकता सेट नहीं की गई है.

offerDetails

object (OfferDetails)

ऑफ़र की जानकारी, जैसे कि छूट, बुकिंग की कीमत वगैरह. यह जानकारी देना ज़रूरी है.

offerRestrictions

object (OfferRestrictions)

इससे पता चलता है कि ऑफ़र पर किस तरह की पाबंदी लगाई गई है. जैसे, क्या सदस्यता/पेमेंट करने का तरीका ज़रूरी है, क्या इस ऑफ़र को अन्य ऑफ़र (और किस तरह के ऑफ़र) के साथ जोड़ा जा सकता है वगैरह. ज़रूरी है.

coupon

object (Coupon)

कूपन की जानकारी. offerCategory के लिए ज़रूरी है: OFFER_CATEGORY_ADD_ON_COUPON_OFFER.

paymentInstrument

object (PaymentInstrument)

पेमेंट करने के तरीके की जानकारी. offerCategory: OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER के लिए ज़रूरी है.

subscription

object (Subscription)

सदस्यता की जानकारी. offerCategory: OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER के लिए ज़रूरी है.

terms

object (Terms)

ऑफ़र के नियम और शर्तें. ज़रूरी है.

validityPeriods[]

object (ValidityPeriod)

ऑफ़र के मान्य रहने की अवधि. इससे पता चलता है कि ऑफ़र किस समयावधि के लिए मान्य है. इसमें शुरू और खत्म होने का समय, हफ़्ते के दिन वगैरह शामिल हैं. यह ज़रूरी है.

offerUrl

string

कारोबारी या कंपनी के ऑफ़र पेज का यूआरएल. offerCategory: OFFER_CATEGORY_BASE_OFFER के लिए ज़रूरी है.

imageUrl

string

कारोबारी या कंपनी के ऑफ़र की इमेज का यूआरएल.

tags[]

enum (OfferTag)

ऑफ़र से जुड़े खास टैग. इसका इस्तेमाल, "त्योहार", "सबसे ज़्यादा रेटिंग वाला", "सबसे ज़्यादा बुक किया गया" जैसे खास ऑफ़र की पहचान करने के लिए किया जाता है.

brandId

string

इससे ऑफ़र से जुड़े ब्रैंड की पहचान होती है. अगर यह नीति सेट नहीं की गई है, तो डिफ़ॉल्ट ब्रैंड का इस्तेमाल किया जाता है.

OfferDetails

[START offer_details_definition] Next tag: 15

JSON के काेड में दिखाना
{
  "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.
}
फ़ील्ड
offerDisplayText

string

ऑफ़र देने वाला व्यक्ति या कंपनी, खोज नतीजों के पेज पर खरीदारों को ऑफ़र का जो टेक्स्ट दिखाना चाहती है. ज़रूरी है.

maxDiscountValue

object (Money)

ज़्यादा से ज़्यादा मिलने वाली छूट. उदाहरण के लिए, 10,000 रुपये तक की खरीदारी पर 10% की छूट.

minSpendValue

object (Money)

छूट पाने के लिए, कम से कम खर्च की जाने वाली रकम. उदाहरण के लिए, कुल कीमत 100 डॉलर या इससे ज़्यादा होने पर 10% की छूट.

bookingCost

object (Money)

इस ऑफ़र को बुक करने का शुल्क. उदाहरण के लिए, 15 डॉलर में टेबल बुक करने पर, फ़ाइनल बिल में 100 डॉलर की छूट.

bookingCostUnit

enum (FeeUnit)

बुकिंग शुल्क की इकाई. उदाहरण के लिए, हर व्यक्ति के लिए, हर लेन-देन के लिए.

convenienceFee

object (Fee)

bookingCostAdjustable

boolean

बुकिंग की लागत को अडजस्ट किया जा सकता है या नहीं. इसका मतलब है कि बुकिंग की लागत को फ़ाइनल बिल से घटाया जाता है. उदाहरण के लिए: बुकिंग करने पर डिनर के लिए 30% की छूट. बुकिंग के लिए 15 डॉलर का शुल्क लिया जाएगा. यह शुल्क, कुल बिल में शामिल किया जाएगा. इसलिए, फ़ाइनल बिल: खर्च की गई कुल रकम - 30% - 15 डॉलर

additionalFees[]

object (AdditionalFee)

उपयोगकर्ता से लिया जाने वाला अतिरिक्त शुल्क. उदाहरण: सुविधा शुल्क, हैंडलिंग शुल्क, डिलीवरी शुल्क, पैकेजिंग शुल्क, सेवा शुल्क वगैरह.

giftCardInfo

object (GiftCardInfo)

उपहार कार्ड के ऑफ़र के बारे में जानकारी.

यूनियन फ़ील्ड offer_specification. यह छूट, प्रतिशत या कुल वैल्यू में से घटाई गई तय वैल्यू के तौर पर हो सकती है. उदाहरण के लिए: 1. कुल बिल पर 10% की छूट. 2. ऑर्डर पर 15 डॉलर की छूट. व्यापारी/कंपनी/कारोबारी, ज़रूरी जानकारी वाले फ़ील्ड का इस्तेमाल करके, अपनी पसंद के मुताबिक छूट भी दे सकते हैं. जैसे, ‘एक खरीदें, एक मुफ़्त पाएं’. ज़रूरी है. offer_specification इनमें से सिर्फ़ एक हो सकता है:
discountPercent

number

बिल के उस हिस्से का प्रतिशत जिस पर छूट दी गई है. [0, 100] पूरे खाने पर लागू होने वाले 1+1 या 50% छूट वाले ऑफ़र के लिए, इस वैल्यू को 50 पर सेट किया जा सकता है. जैसे, 1+1 बुफ़े, पूरे बिल पर 1+1, सेट मेन्यू पर 1+1.

discountValue

object (Money)

छूट की तय वैल्यू.

otherOfferDetailText

string

छूट के बारे में बताने के लिए, फ़्री-फ़ॉर्म टेक्स्ट. अगर 1+1 वाले खास ऑफ़र (जैसे, 1+1 ड्रिंक, +1 मेन कोर्स, मेन्यू में मौजूद चुनिंदा आइटम पर 1+1 ऑफ़र) उपलब्ध हैं, तो उनकी जानकारी यहां दी जानी चाहिए.

OfferRestrictions

[START offer_restrictions_definition] Next tag: 11

JSON के काेड में दिखाना
{
  "combinableWithOtherOffers": boolean,
  "combinableOfferCategories": [
    enum (OfferCategory)
  ],
  "combinableOfferIds": [
    string
  ],
  "inclusions": [
    {
      object (OfferCondition)
    }
  ],
  "exclusions": [
    {
      object (OfferCondition)
    }
  ],
  "minGuest": integer,
  "foodOfferRestrictions": {
    object (FoodOfferRestrictions)
  },
  "specialConditions": [
    string
  ]
}
फ़ील्ड
combinableWithOtherOffers

boolean

इस ऑफ़र को अन्य ऑफ़र के साथ इस्तेमाल किया जा सकता है या नहीं. 'सही है' पर सेट होने पर, पार्टनर यह तय कर सकते हैं कि इस ऑफ़र को किन ऑफ़र के साथ जोड़ा जा सकता है. अगर combinableOfferCategories और combinableOfferIds, दोनों सेट किए गए हैं, तो ऊपर दी गई किसी भी शर्त को पूरा करने वाला ऑफ़र, जोड़ा जा सकेगा.

combinableOfferCategories[]

enum (OfferCategory)

उन ऑफ़र टाइप की सूची जिनके साथ इस ऑफ़र को जोड़ा जा सकता है. उदाहरण के लिए, इस ऑफ़र को अन्य कूपन के साथ इस्तेमाल किया जा सकता है. अगर combinableWithOtherOffers फ़ील्ड की वैल्यू 'सही है' पर सेट है और इस फ़ील्ड को सेट नहीं किया गया है, तो सभी टाइप के ऑफ़र को एक साथ इस्तेमाल किया जा सकेगा.

combinableOfferIds[]

string

उन offer_id की सूची जिनके साथ इस ऑफ़र को जोड़ा जा सकता है. ऐसा हो सकता है कि कुछ ऑफ़र को सिर्फ़ कुछ खास offer_id (इन्हें पैरंट ऑफ़र माना जा सकता है) के साथ जोड़ा जा सके. अगर combinableWithOtherOffers फ़ील्ड की वैल्यू 'सही है' पर सेट है और इस फ़ील्ड को सेट नहीं किया गया है, तो सभी ऑफ़र आईडी को एक साथ इस्तेमाल किया जा सकेगा.

inclusions[]

object (OfferCondition)

उन शर्तों की सूची जो ऑफ़र के मान्य होने के लिए पूरी होनी चाहिए. जैसे, बिना अल्कोहल वाली ड्रिंक, खाना.

exclusions[]

object (OfferCondition)

उन शर्तों की सूची जिनकी वजह से ऑफ़र अमान्य हो जाएगा. जैसे, बुफ़े, कॉम्बो ऑफ़र, और कॉकटेल.

minGuest

integer

ऑफ़र का फ़ायदा पाने के लिए, कम से कम इतने लोग होने चाहिए.

foodOfferRestrictions

object (FoodOfferRestrictions)

खाने-पीने की चीज़ों के ऑफ़र पर लागू होने वाली पाबंदियां.

specialConditions[]

string

इस ऑफ़र के लिए खास शर्तें, जो उपयोगकर्ता को दिखानी ज़रूरी हैं. उदाहरण: "सिर्फ़ [इलाका] में पेमेंट के लिए मान्य है", "ऑनलाइन पेमेंट शामिल नहीं है"

OfferCondition

[START offer_condition_definition]

JSON के काेड में दिखाना
{
  "description": string
}
फ़ील्ड
description

string

PaymentInstrument

[START payment_instrument_definition]

JSON के काेड में दिखाना
{
  "items": [
    {
      object (PaymentInstrumentItem)
    }
  ],
  "providerName": string
}
फ़ील्ड
items[]

object (PaymentInstrumentItem)

पेमेंट करने के उन तरीकों की सूची जिनका इस्तेमाल करके ऑफ़र का फ़ायदा लिया जा सकता है. ज़रूरी है.

providerName

string

पेमेंट करने के तरीके की सुविधा देने वाली कंपनी का नाम. यह कोई बैंकिंग पार्टनर, बैंक का नाम वगैरह हो सकता है. उदाहरण के लिए: American Express, HDFC, ICICI.

PaymentInstrumentItem

[START payment_instrument_item_definition]

JSON के काेड में दिखाना
{
  "type": enum (PaymentInstrumentType),
  "name": string
}
फ़ील्ड
type

enum (PaymentInstrumentType)

पेमेंट करने के तरीके का टाइप. ज़रूरी है.

name

string

पेमेंट करने के तरीके का नाम, जैसे कि क्रेडिट कार्ड का नाम. उदाहरण के लिए: HDFC Infinia, American Express Platinum. ज़रूरी है.

सदस्यता

[START subscription_definition]

JSON के काेड में दिखाना
{
  "name": string,
  "subscriptionAutoAdded": boolean,
  "cost": {
    object (Money)
  },
  "subscriptionDuration": string,
  "termsAndConditionsUrl": string
}
फ़ील्ड
name

string

सदस्यता का नाम. ज़रूरी है.

subscriptionAutoAdded

boolean

यह तय करें कि जब कोई उपयोगकर्ता इस ऑफ़र का फ़ायदा लेता है, तो सदस्यता अपने-आप जुड़ जाए या नहीं

cost

object (Money)

सदस्यता का शुल्क. ज़रूरी है.

subscriptionDuration

string (Duration format)

सदस्यता शुल्क [subscription_cost] एट्रिब्यूट की वैल्यू के हिसाब से, सदस्यता कितने समय के लिए मान्य है. ज़रूरी है.

यह सेकंड में अवधि होती है. इसमें नौ दशमलव अंक हो सकते हैं. यह 's' पर खत्म होती है. उदाहरण: "3.5s".

termsAndConditionsUrl

string

इस सदस्यता से जुड़े पार्टनर के नियमों और शर्तों का यूआरएल.

शर्तें

[START terms_definition]

JSON के काेड में दिखाना
{
  "url": string,
  "restrictedToCertainUsers": boolean,
  "termsAndConditions": string,
  "additionalTermsAndConditions": [
    string
  ]
}
फ़ील्ड
url

string

पार्टनर के नियमों और शर्तों का यूआरएल.

restrictedToCertainUsers

boolean

क्या ऑफ़र कुछ ही उपयोगकर्ताओं के लिए उपलब्ध है.

termsAndConditions

string

पार्टनर की ओर से उपलब्ध कराए गए मुख्य नियम और शर्तें.

additionalTermsAndConditions[]

string

पार्टनर की मुख्य शर्तों के अलावा अन्य नियम और शर्तें.