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

אם הערך הוא true, המבצע הזה חל על כל הישויות שמשויכות למצטבר. המאפיין הזה רלוונטי רק למבצעים של חבילות ערוצים.
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

כתובת ה-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)

ההנחה המקסימלית שאפשר לקבל. לדוגמה, 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, הנחה של 50% על כל החשבון, 1+1 על תפריט קבוע), אפשר להגדיר את הערך הזה כ-50.
discountValue

object (Money)

ערך קבוע של ההנחה.
otherOfferDetailText

string

טקסט חופשי שמתאר את ההנחה. אם מציעים מבצעים ספציפיים של 1+1 (למשל: משקה אחד ועוד אחד, מנה עיקרית אחת ועוד אחת, פריט אחד ועוד אחד בתפריט נבחר), צריך לציין את הפרטים האלה כאן.

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

האם אפשר לשלב את המבצע הזה עם מבצעים אחרים. אם הערך הוא true, השותפים יכולים לציין עם אילו מבצעים אפשר לשלב את המבצע הזה. אם הגדרתם גם את combinableOfferCategories וגם את combinableOfferIds, כל מבצע שתואם לאחד מהתנאים שלמעלה יהיה ניתן לשילוב.
combinableOfferCategories[]

enum (OfferCategory)

רשימה של סוגי מבצעים שאפשר לשלב עם המבצע הזה. לדוגמה, יכול להיות שאפשר יהיה לשלב את המבצע הזה עם שוברים אחרים. אם הערך של combinableWithOtherOffers הוא true והשדה הזה לא מוגדר, אפשר לשלב את כל הסוגים.
combinableOfferIds[]

string

רשימה של מזהי מבצעים שאפשר לשלב עם המבצע הזה. יכול להיות שמבצעים מסוימים ניתנים לשילוב רק עם מזהי מבצעים ספציפיים אחרים (אפשר להתייחס אליהם כמבצעים ראשיים). אם הערך של המאפיין combinableWithOtherOffers הוא true והמאפיין הזה לא מוגדר, אפשר לשלב את כל מזהי המבצעים.
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

השם של ספק אמצעי התשלום. יכול להיות שם של שותף בנקאי, שם של בנק וכו'. לדוגמה: אמריקן אקספרס,‏ HDFC,‏ ICICI.

PaymentInstrumentItem

[START payment_instrument_item_definition]

ייצוג ב-JSON 
{
  "type": enum (PaymentInstrumentType),
  "name": string
}
שדות
type

enum (PaymentInstrumentType)

סוג אמצעי התשלום. חובה.
name

string

שם פריט אמצעי התשלום, כמו שם כרטיס האשראי. לדוגמה: HDFC Infinia, ‏ אמריקן אקספרס 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

תנאים והגבלות בנוסף לתנאים ולהגבלות העיקריים של השותף.