Offer

LINT.IfChange(offer_definition) [شروع offer_definition] برچسب بعدی: ۲۶

نمایش 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 )

جزئیات کوپن. برای پیشنهاد الزامی است. دسته بندی: OFFER_CATEGORY_ADD_ON_COUPON_OFFER.

paymentInstrument

object ( PaymentInstrument )

جزئیات ابزار پرداخت. مورد نیاز برای دسته بندی پیشنهاد: OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER.

subscription

object ( Subscription )

جزئیات اشتراک. برای پیشنهاد الزامی است. دسته بندی: OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER.

terms

object ( Terms )

شرایط و ضوابط پیشنهاد. الزامی.

validityPeriods[]

object ( ValidityPeriod )

مدت اعتبار پیشنهاد. مدت زمانی که پیشنهاد معتبر است را شرح می‌دهد، از جمله زمان شروع و پایان، روزهای هفته و غیره. الزامی است.

offerUrl

string

آدرس اینترنتی (URL) صفحه پیشنهاد فروشنده. برای دسته بندی پیشنهاد الزامی است: OFFER_CATEGORY_BASE_OFFER.

imageUrl

string

نشانی اینترنتی (URL) تصویر پیشنهاد فروشنده.

tags[]

enum ( OfferTag )

برچسب‌های ویژه مرتبط با پیشنهاد. این مورد برای شناسایی پیشنهادهای ویژه مانند «جشن»، «پرامتیازترین»، «پررزروترین» و غیره استفاده می‌شود.

brandId

string

برای معاملات کارت هدیه، شناسایی برند ارائه دهنده معامله الزامی است.

جزئیات پیشنهاد

[شروع جزئیات_تعریف_پیشنهاد] برچسب بعدی: ۱۵

نمایش 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٪ تخفیف تا سقف 100 دلار.

minSpendValue

object ( Money )

حداقل مبلغ قابل پرداخت برای استفاده از تخفیف. به عنوان مثال، 10٪ تخفیف وقتی قیمت کل 100 دلار یا بیشتر باشد.

bookingCost

object ( Money )

هزینه رزرو این پیشنهاد. به عنوان مثال، ۱۰۰ دلار تخفیف از صورتحساب نهایی در صورت رزرو میز با هزینه ۱۵ دلار.

bookingCostUnit

enum ( FeeUnit )

واحد هزینه رزرو. به عنوان مثال، به ازای هر نفر، به ازای هر تراکنش.

convenienceFee

object ( Fee )

bookingCostAdjustable

boolean

آیا هزینه رزرو قابل تنظیم است، یعنی هزینه رزرو از صورتحساب نهایی کسر می‌شود؟ برای مثال: 30٪ تخفیف شام با رزرو. هزینه رزرو 15 دلار است و در صورتحساب نهایی اعمال می‌شود. بنابراین صورتحساب نهایی: کل هزینه - 30٪ - 15 دلار

additionalFees[]

object ( AdditionalFee )

هزینه‌های اضافی که از کاربر دریافت می‌شود. مثال‌ها: راحتی، جابجایی، تحویل، بسته‌بندی، هزینه خدمات و غیره

giftCardInfo

object ( GiftCardInfo )

جزئیات مخصوص معاملات کارت هدیه.

فیلد اتحادیه offer_specification . تخفیف می‌تواند درصد یا مقدار ثابتی باشد که از کل مبلغ کسر می‌شود. برای مثال: ۱. ۱۰٪ تخفیف روی صورتحساب نهایی. ۲. ۱۵ دلار تخفیف روی یک سفارش. فروشندگان همچنین می‌توانند تخفیف‌های سفارشی مانند «یکی بخر، یکی رایگان» را از طریق فیلدهای مشخصات مربوطه ارائه دهند. الزامی است. offer_specification فقط می‌تواند یکی از موارد زیر باشد:
discountPercent

number

درصدی از صورتحساب که تخفیف می‌گیرد. [0، 100] برای پیشنهادهای تخفیف 1+1 یا 50% که برای کل غذا اعمال می‌شوند (مثلاً 1+1 بوفه، 1+1 روی کل صورتحساب، 1+1 روی منوی انتخابی)، این مقدار را می‌توان روی 50 تنظیم کرد.

discountValue

object ( Money )

مقدار ثابت تخفیف.

otherOfferDetailText

string

متن آزاد برای توصیف تخفیف. برای پیشنهادات خاص ۱+۱ (مثلاً ۱+۱ نوشیدنی، ۱+۱ غذای اصلی، ۱+۱ مورد از منوی انتخابی)، این جزئیات باید در اینجا شرح داده شوند.

محدودیت‌های پیشنهاد

[شروع پیشنهاد_محدودیت‌ها_تعریف] برچسب بعدی: ۱۱

نمایش 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

فهرست شناسه‌های پیشنهادی که این پیشنهاد می‌تواند با آنها ترکیب شود. برخی از پیشنهادها فقط می‌توانند با شناسه‌های پیشنهادی خاص دیگری ترکیب شوند (که می‌توانند به عنوان پیشنهادهای والد در نظر گرفته شوند). اگر مقدار combinableWithOtherOffers برابر با true باشد و این فیلد تنظیم نشده باشد، همه شناسه‌های پیشنهاد قابل ترکیب خواهند بود.

inclusions[]

object ( OfferCondition )

فهرست شرایطی که باید برای معتبر بودن پیشنهاد رعایت شوند (مثلاً نوشیدنی‌های غیرالکلی، غذا).

exclusions[]

object ( OfferCondition )

فهرست شرایطی که پیشنهاد را باطل می‌کند (مثلاً بوفه، پیشنهادهای ترکیبی و کوکتل).

minGuest

integer

حداقل تعداد نفرات مورد نیاز برای استفاده از پیشنهاد.

foodOfferRestrictions

object ( FoodOfferRestrictions )

محدودیت‌های خاص مربوط به پیشنهادات غذایی.

specialConditions[]

string

شرایط ویژه این پیشنهاد که باید به کاربر نشان داده شود. مثال‌ها: «فقط برای پرداخت در [منطقه] معتبر است»، «پرداخت‌های آنلاین شامل نمی‌شود»

پیشنهادشرایط

[شروع تعریف_شرایط_پیشنهاد]

نمایش JSON 
{
  "description": string
}
فیلدها
description

string

ابزار پرداخت

[شروع تعریف ابزار پرداخت]

نمایش JSON 
{
  "items": [
    {
      object (PaymentInstrumentItem)
    }
  ],
  "providerName": string
}
فیلدها
items[]

object ( PaymentInstrumentItem )

فهرست ابزارهای پرداختی که می‌توان برای استفاده از این پیشنهاد استفاده کرد. الزامی.

providerName

string

نام ارائه‌دهنده ابزار پرداخت. می‌تواند یک شریک بانکی، نام یک بانک و غیره باشد. برای مثال: American Express، HDFC، ICICI.

ابزار پرداخت

[شروع تعریف_ابزار_پرداخت_مورد]

نمایش JSON 
{
  "type": enum (PaymentInstrumentType),
  "name": string
}
فیلدها
type

enum ( PaymentInstrumentType )

نوع ابزار پرداخت. الزامی.

name

string

نام ابزار پرداخت مانند نام کارت اعتباری. برای مثال: HDFC Infinia، American Express Platinum. الزامی است.

اشتراک

[شروع تعریف اشتراک]

نمایش 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

نشانی اینترنتی (URL) مربوط به شرایط و ضوابط شریک مربوط به این اشتراک.

شرایط

[شروع تعریف اصطلاحات]

نمایش JSON 
{
  "url": string,
  "restrictedToCertainUsers": boolean,
  "termsAndConditions": string,
  "additionalTermsAndConditions": [
    string
  ]
}
فیلدها
url

string

نشانی اینترنتی (URL) شرایط و ضوابط شریک.

restrictedToCertainUsers

boolean

اینکه آیا این پیشنهاد محدود به کاربران خاصی است یا خیر.

termsAndConditions

string

متن شرایط و ضوابط اولیه ارائه شده توسط شریک.

additionalTermsAndConditions[]

string

شرایط و ضوابط علاوه بر شرایط و ضوابط اولیه از طرف شریک.