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

সোর্সের অ্যাসাইন করা অফারের অগ্রাধিকারের লেভেল নির্দেশ করে এমন ঋণাত্মক নয় এমন পূর্ণসংখ্যা ([১-১০০], যেখানে ১ হল সর্বোচ্চ অগ্রাধিকার)। একই মার্চেন্টের জন্য একাধিক অফার উপলভ্য থাকলে, এটি অফার র‍্যাঙ্কিংয়ের জন্য একটি সিগন্যাল হবে। ০ থাকলে বুঝতে হবে যে অগ্রাধিকার সেট করা নেই।

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

মার্চেন্টের অফার পৃষ্ঠার URL. offerCategory: OFFER_CATEGORY_BASE_OFFER-এর জন্য প্রয়োজন।

imageUrl

string

মার্চেন্টের অফার ছবির URL.

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)

সর্বাধিক যে পরিমাণ ছাড় পাওয়া যেতে পারে। যেমন, $১০০ পর্যন্ত ১০% ছাড়।

minSpendValue

object (Money)

ছাড়ের সুবিধা পেতে ন্যূনতম যে পরিমাণ খরচ করতে হবে। যেমন, মোট দাম $১০০ বা তার বেশি হলে ১০% ছাড়।

bookingCost

object (Money)

এই অফার বুক করার খরচ। যেমন, $১৫-এর বিনিময়ে টেবিল রিজার্ভ করলে চূড়ান্ত বিলে $১০০ ছাড়।

bookingCostUnit

enum (FeeUnit)

বুকিং খরচের ইউনিট। যেমন, ব্যক্তি প্রতি, ট্রানজ্যাকশন প্রতি।

convenienceFee

object (Fee)

bookingCostAdjustable

boolean

বুকিংয়ের খরচ অ্যাডজাস্ট করা যায় কিনা, অর্থাৎ বুকিংয়ের খরচ চূড়ান্ত বিল থেকে বাদ দেওয়া হয় কিনা। যেমন: রিজার্ভেশন সহ ডিনারে ৩০% ছাড়। রিজার্ভ করার খরচ $১৫ এবং এটি চূড়ান্ত বিলে যোগ করা হবে। তাই চূড়ান্ত বিল: মোট খরচ - ৩০% - $১৫

additionalFees[]

object (AdditionalFee)

ব্যবহারকারীকে চার্জ করা অতিরিক্ত ফি। যেমন: কনভেনিয়েন্স, হ্যান্ডলিং, ডেলিভারি, প্যাকেজিং, পরিষেবা ফি ইত্যাদি।

giftCardInfo

object (GiftCardInfo)

গিফ্ট কার্ড ডিলের জন্য নির্দিষ্ট বিবরণ।

ইউনিয়ন ফিল্ড offer_specification। ছাড়ের পরিমাণ শতকরা হিসেবে বা মোট মূল্য থেকে বিয়োগ করা নির্দিষ্ট সংখ্যা হিসেবে দেখানো যেতে পারে। যেমন: ১. চূড়ান্ত বিলে ১০% ছাড়। ২. অর্ডারে $১৫ ছাড়। এছাড়াও, মার্চেন্টরা প্রাসঙ্গিক স্পেসিফিকেশন ফিল্ডের মাধ্যমে ‘একটি কিনলে একটি ফ্রি’ অফারের মতো কাস্টম ছাড় দিতে পারেন। প্রয়োজনীয়। offer_specification শুধুমাত্র নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
discountPercent

number

বিল থেকে ছাড় দেওয়া অর্থের শতকরা হার। [0, 100] ১+১ বা ৫০% ছাড়ের অফার যা পুরো খাবারের উপর প্রযোজ্য (যেমন, ১+১ বুফে, পুরো বিলে ১+১, সেট মেনুতে ১+১), এই ভ্যালু ৫০-এ সেট করা যেতে পারে।

discountValue

object (Money)

ছাড়ের নির্দিষ্ট ভ্যালু।

otherOfferDetailText

string

ছাড়ের বিবরণ দেওয়ার জন্য ফ্রি-ফর্ম টেক্সট। নির্দিষ্ট ১+১ অফারের (যেমন, ১+১ ড্রিঙ্ক, +১ মেন কোর্স, ১+১ বেছে নেওয়া মেনু আইটেম) জন্য, এইসব বিবরণ এখানে বর্ণনা করা উচিত।

OfferRestrictions

[START offer_restrictions_definition] পরবর্তী ট্যাগ: 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-এর মান true হলে এবং এই ফিল্ড সেট করা না থাকলে, সব ধরনের অফার একত্রিত করা যাবে।

combinableOfferIds[]

string

এই অফারের সাথে যোগ করা যাবে এমন offer_id-এর তালিকা। কিছু অফার শুধুমাত্র নির্দিষ্ট কিছু offer_ids-এর সাথে যোগ করা যেতে পারে (এগুলিকে পেরেন্ট অফার হিসেবে বিবেচনা করা যেতে পারে)। combinableWithOtherOffers-এর মান true হলে এবং এই ফিল্ড সেট করা না থাকলে, সব অফার আইডি একত্রিত করা যাবে।

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

পেমেন্ট ইন্সট্রুমেন্ট আইটেমের নাম, যেমন ক্রেডিট কার্ডের নাম। যেমন: 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

এই সাবস্ক্রিপশনের সাথে প্রাসঙ্গিক পার্টনারের নিয়ম ও শর্তাবলীর URL.

শর্তাবলী

[START terms_definition]

JSON উপস্থাপনা
{
  "url": string,
  "restrictedToCertainUsers": boolean,
  "termsAndConditions": string,
  "additionalTermsAndConditions": [
    string
  ]
}
ফিল্ড
url

string

পার্টনারের নিয়ম ও শর্তাবলীর URL।

restrictedToCertainUsers

boolean

অফারটি নির্দিষ্ট কিছু ব্যবহারকারীর জন্য সীমাবদ্ধ কিনা।

termsAndConditions

string

পার্টনারের প্রদান করা প্রাথমিক নিয়ম ও শর্তাবলীর টেক্সট।

additionalTermsAndConditions[]

string

পার্টনারের প্রাথমিক নিয়ম ও শর্তাবলী ছাড়াও অতিরিক্ত নিয়ম ও শর্তাবলী।