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)

ज़्यादा से ज़्यादा कितनी छूट मिल सकती है. उदाहरण के लिए, 100 डॉलर तक की खरीदारी पर 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

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

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

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

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

पेमेंट के तरीके के नाम की जानकारी. जैसे, क्रेडिट कार्ड का नाम. उदाहरण के लिए: एचडीएफ़सी इनफ़िनिया, अमेरिकन एक्सप्रेस प्लैटिनम. ज़रूरी है.

सदस्यता

[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)

यह जानकारी देती है कि सदस्यता शुल्क में सदस्यता कितने समय के लिए मान्य है. ज़रूरी है.

यह सेकंड में अवधि होती है. इसमें नौ दशमलव अंक तक हो सकते हैं. इसके आखिर में '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

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