REST Resource: eventticketobject

משאב: EventTicketObject

ייצוג JSON 
{
  "kind": string,
  "classReference": {
    object (EventTicketClass)
  },
  "seatInfo": {
    object (EventSeat)
  },
  "reservationInfo": {
    object (EventReservationInfo)
  },
  "ticketHolderName": string,
  "ticketNumber": string,
  "ticketType": {
    object (LocalizedString)
  },
  "faceValue": {
    object (Money)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "linkedOfferIds": [
    string
  ],
  "hexBackgroundColor": string,
  "id": string,
  "classId": string,
  "version": string,
  "state": enum (State),
  "barcode": {
    object (Barcode)
  },
  "messages": [
    {
      object (Message)
    }
  ],
  "validTimeInterval": {
    object (TimeInterval)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "hasUsers": boolean,
  "smartTapRedemptionValue": string,
  "hasLinkedDevice": boolean,
  "disableExpirationNotification": boolean,
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "heroImage": {
    object (Image)
  },
  "passConstraints": {
    object (PassConstraints)
  }
}
שדות
kind
(deprecated)

string

מזהה את סוג המשאב הזה. ערך: המחרוזת הקבועה "walletobjects#eventTicketObject".
classReference

object (EventTicketClass)

עותק של השדות שעברו בירושה של מחלקת ההורה. השדות האלה מאוחזרים במהלך GET.
seatInfo

object (EventSeat)

פרטי המושבה של הכרטיס הזה.
reservationInfo

object (EventReservationInfo)

פרטי ההזמנה של הכרטיס הזה. אנחנו צפויים לשתף את המידע הזה בין כל הכרטיסים שנרכשו באותה הזמנה.
ticketHolderName

string

השם של בעל הכרטיס, אם הכרטיס מוקצה לאדם מסוים. לדוגמה, "ישראל ישראלי" או "פלונית".
ticketNumber

string

מספר הכרטיס. המזהה הזה יכול להיות מזהה ייחודי בכל הכרטיסים במערכת של המנפיק, בכל הכרטיסים לאירוע (למשל XYZ1234512345) או בכל הכרטיסים בהזמנה (1, 2, 3 וכו').
ticketType

object (LocalizedString)

סוג הכרטיס, כמו 'למבוגרים בלבד' או 'ילד', 'VIP' או 'רגיל'.
faceValue

object (Money)

הערך הנקוב של הכרטיס, תואם למה שיודפס בגרסה הפיזית של הכרטיס.
groupingInfo

object (GroupingInfo)

מידע שקובע איך הכרטיסים יקובצו יחד.
linkedOfferIds[]

string

רשימת אובייקטים של מבצע שמקושרים לכרטיס לאירוע הזה. האובייקטים של המבצע חייבים להיות כבר קיימים.

מזהי אובייקטים של מבצעים צריכים להיות בפורמט issuer ID.identifier שבו הראשון הונפק על ידי Google והאחרון נבחר על ידך.
hexBackgroundColor

string

צבע הרקע של הכרטיס. אם לא מגדירים את הצבע הדומיננטי של התמונה הראשית, ואם לא מוגדרת תמונה ראשית, נעשה שימוש בצבע הדומיננטי של הלוגו. הפורמט הוא #rrggbb, כאשר rrggbb הוא משולש הקסדצימלי ב-RGB, כמו #ffcc00. אפשר גם להשתמש בגרסה המקוצרת של משולש ה-RGB שהיא #rgb, כמו #fc0.
id

string

חובה. המזהה הייחודי של אובייקט. המזהה הזה חייב להיות ייחודי בכל האובייקטים של המנפיק. הערך הזה צריך להיות בפורמט issuer ID.identifier שבו הראשון הונפק על ידי Google והאחרון נבחר על ידך. המזהה הייחודי יכול לכלול רק תווים אלפאנומריים, '.', '_' או '-'.
classId

string

חובה. המחלקה שמשויכת לאובייקט הזה. המחלקה חייבת להיות מאותו סוג כמו האובייקט הזה, היא חייבת להיות כבר קיימת וחייבת להיות מאושרת.

מזהי מחלקות צריכים להיות בפורמט issuer ID.identifier שבו הראשון הונפק על ידי Google והאחרון נבחר על ידך.
version
(deprecated)

string (int64 format)

הוצא משימוש
state

enum (State)

חובה. מצב האובייקט. השדה הזה משמש לקביעת אופן ההצגה של אובייקט באפליקציה. לדוגמה, אובייקט inactive מועבר לקטע 'כרטיסים שפג תוקפם'.
barcode

object (Barcode)

הסוג והערך של הברקוד.
messages[]

object (Message)

מערך הודעות שמוצגות באפליקציה. כל המשתמשים באובייקט הזה יקבלו את ההודעות המשויכות אליו. המספר המקסימלי של השדות האלה הוא 10.
validTimeInterval

object (TimeInterval)

פרק הזמן שבו האובייקט הזה יהיה active ואפשר להשתמש בו. מצב האובייקט ישתנה ל-expired בתום התקופה הזו.
locations[]

object (LatLongPoint)

הערה: בשלב זה השדה הזה לא נתמך להפעלת התראות גיאוגרפיות.
hasUsers

boolean

מציין אם לאובייקט יש משתמשים. השדה הזה מוגדר על ידי הפלטפורמה.
smartTapRedemptionValue

string

הערך שיועבר למסוף מאושר בהקשה חכמה ב-NFC עבור האובייקט הזה. גם השדות ברמת הכיתה enableSmartTap ו-redemptionIssuers חייבים להיות מוגדרים כראוי כדי שהכרטיס יוכל לתמוך בהקשה חכמה. יש תמיכה בתווי ASCII בלבד.
hasLinkedDevice

boolean

אם האובייקט הזה מקושר כרגע למכשיר אחד. השדה הזה מוגדר על ידי הפלטפורמה כשמשתמש שומר את האובייקט ומקשר אותו למכשיר שלו. מיועד לשימוש על ידי שותפים נבחרים. לקבלת מידע נוסף, אפשר לפנות לתמיכה.
disableExpirationNotification

boolean

שדה זה מציין אם יש להסתיר את ההתראות באופן מפורש. אם השדה הזה מוגדר כ-True, לא משנה מה השדה messages, התראות התפוגה שנשלחות למשתמש יושבתו. כברירת מחדל, השדה הזה מוגדר כ-False.

כרגע אפשר להגדיר את האפשרות הזו רק למבצעים.
infoModuleData

object (InfoModuleData)

הוּצא משימוש. במקומו צריך להשתמש ב-textModulesData.
imageModulesData[]

object (ImageModuleData)

נתונים של מודול התמונה. המספר המקסימלי של השדות המוצגים הוא 1 ברמת האובייקט ו-1 ברמת האובייקט של הכיתה.
textModulesData[]

object (TextModuleData)

נתונים של מודול טקסט. אם נתונים של מודול טקסט מוגדרים גם במחלקה, שניהם יוצגו. המספר המקסימלי של השדות המוצגים הוא 10 מהאובייקט ו-10 מהמחלקה.
rotatingBarcode

object (RotatingBarcode)

הסוג והערך של הברקוד המסתובב.
heroImage

object (Image)

תמונת באנר אופציונלית מוצגת בחזית הכרטיס. אם אין תעודה מזהה, תוצג התמונה הראשית של הכיתה (אם יש כזו). אם גם התמונה הראשית (Hero) של הכיתה לא מוצגת, שום דבר לא יוצג.
passConstraints

object (PassConstraints)

מעבירים את האילוצים של האובייקט. כולל הגבלת התנהגויות של NFC וצילומי מסך.

EventSeat

ייצוג JSON 
{
  "kind": string,
  "seat": {
    object (LocalizedString)
  },
  "row": {
    object (LocalizedString)
  },
  "section": {
    object (LocalizedString)
  },
  "gate": {
    object (LocalizedString)
  }
}
שדות
kind
(deprecated)

string

מזהה את סוג המשאב הזה. ערך: המחרוזת הקבועה "walletobjects#eventSeat".
seat

object (LocalizedString)

מספר המושב, למשל '1', '2', '3' או כל מזהה מושב אחר.

השדה הזה ניתן להתאמה לשוק המקומי, כך שאפשר לתרגם מילים או להשתמש באלפבית של התווים השונים במזהה.
row

object (LocalizedString)

את השורה של המושב, למשל "1", E, "BB" או "A5".

השדה הזה ניתן להתאמה לשוק המקומי, כך שאפשר לתרגם מילים או להשתמש באלפבית של התווים השונים במזהה.
section

object (LocalizedString)

קטע המושב, למשל "121".

השדה הזה ניתן להתאמה לשוק המקומי, כך שאפשר לתרגם מילים או להשתמש באלפבית של התווים השונים במזהה.
gate

object (LocalizedString)

השער שבעלי הכרטיס צריכים להיכנס אליו כדי לגשת למושב שלו, למשל "A" או "מערב".

השדה הזה ניתן להתאמה לשוק המקומי, כך שאפשר לתרגם מילים או להשתמש באלפבית של התווים השונים במזהה.

EventReservationInfo

ייצוג JSON 
{
  "kind": string,
  "confirmationCode": string
}
שדות
kind
(deprecated)

string

מזהה את סוג המשאב הזה. ערך: המחרוזת הקבועה "walletobjects#eventReservationInfo".
confirmationCode

string

קוד האישור של הזמנת האירוע. הן יכולות גם להופיע בדמות 'מספר הזמנה', 'מספר אישור', 'מספר הזמנה' או ייצוגים אחרים.

שיטות

addmessage

 הוספת הודעה לאובייקט של כרטיס האירוע שמזהה האובייקט הנתון מפנה אליו.

get

 מחזירה את האובייקט של הכרטיס לאירוע עם מזהה האובייקט הנתון.

insert

 הוספת אובייקט של כרטיס אירוע עם המזהה והמאפיינים הנתונים.

list

 מחזירה רשימה של כל האובייקטים של כרטיסים לאירועים עבור מזהה מנפיק נתון.

modifylinkedofferobjects

 שינוי של האובייקטים של המבצע המקושר באובייקט של כרטיס האירוע עם המזהה הנתון.

patch

 עדכון האובייקט של כרטיס האירוע שמזהה האובייקט הנתון מפנה אליו.

update

 עדכון האובייקט של כרטיס האירוע שמזהה האובייקט הנתון מפנה אליו.