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)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  }
}
שדות
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

צבע הרקע של הכרטיס. אם לא מגדירים את הצבע הדומיננטי של התמונה הראשית (Hero), משתמשים בתמונה הראשית (Hero) אם לא הגדרתם את הצבע הדומיננטי של הלוגו. הפורמט הוא #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

הערך שיועבר למסוף שאושר על ידי Smart Tap דרך 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 וצילומי מסך.
saveRestrictions

object (SaveRestrictions)

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

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

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