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)

تفاصيل قسيمة مطلوب لفئة العرض: 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 لصفحة العرض التي يقدّمها التاجر. مطلوبة لقيمة offerCategory: OFFER_CATEGORY_BASE_OFFER.
imageUrl

string

تمثّل هذه السمة عنوان URL لصورة العرض الترويجي الخاص بالتاجر.
tags[]

enum (OfferTag)

علامات خاصة مرتبطة بالعرض يُستخدَم هذا الحقل لتحديد العروض الخاصة، مثل "موسمي" و"الأكثر تقييمًا" و"الأكثر حجزًا" وما إلى ذلك.
brandId

string

مطلوبة لعروض بطاقات الهدايا لتحديد العلامة التجارية التي تقدّم العرض.

OfferDetails

[START offer_details_definition] العلامة التالية: 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 يصل إلى 100 ريال سعودي.
minSpendValue

object (Money)

تمثّل هذه السمة الحدّ الأدنى لقيمة الإنفاق للاستفادة من الخصم. على سبيل المثال، خصم ‎10% عندما يكون السعر الإجمالي 100 دولار أمريكي أو أكثر.
bookingCost

object (Money)

تمثّل هذه السمة تكلفة حجز هذا العرض. على سبيل المثال، خصم 100 دولار أمريكي من الفاتورة النهائية عند حجز طاولة بتكلفة 15 دولارًا أمريكيًا.
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] بالنسبة إلى عروض "وجبتان بسعر وجبة واحدة" أو عروض الخصم بنسبة% 50 التي تنطبق على الوجبة بأكملها (مثل بوفيه "وجبتان بسعر وجبة واحدة" أو خصم "وجبتان بسعر وجبة واحدة" على الفاتورة بأكملها أو على قائمة الطعام المحدّدة)، يمكن ضبط هذه القيمة على 50.
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

قائمة بمعرّفات العروض التي يمكن الجمع بينها وبين هذا العرض لا يمكن الجمع بين بعض العروض إلا مع أرقام تعريف عروض أخرى معيّنة (يمكن اعتبارها عروضًا رئيسية). إذا كانت قيمة 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)

تحدّد هذه السمة مدة صلاحية الاشتراك مقابل تكلفة الاشتراك. الحقل مطلوب.

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "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

الأحكام والشروط بالإضافة إلى الأحكام والشروط الأساسية من الشريك