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)

الخدمة التي تقدّم العرض يمكن أن ينتمي معرّف العرض إلى نوع إجراء واحد فقط. إذا كان من الممكن مشاركة عرض ترويجي واحد في أنواع خدمات متعددة، من المتوقّع إنشاء عروض ترويجية مكرّرة بمعرّفات فريدة لكل نوع خدمة. الحقل مطلوب.
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

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

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