REST Resource: flightobject

משאב: FlightObject

ייצוג ב-JSON 
{
  "kind": string,
  "classReference": {
    object (FlightClass)
  },
  "passengerName": string,
  "boardingAndSeatingInfo": {
    object (BoardingAndSeatingInfo)
  },
  "reservationInfo": {
    object (ReservationInfo)
  },
  "securityProgramLogo": {
    object (Image)
  },
  "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)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
שדות
kind
(deprecated)

string

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

object (FlightClass)

עותק של השדות שעברו בירושה מכיתה ההורה. השדות האלה מאוחזרים במהלך קריאה מסוג GET.
passengerName

string

חובה. שם הנוסע, כפי שהוא מופיע בכרטיס העלייה למטוס.

לדוגמה: "Dave M Gahan" או "Gahan/Dave" או "GAHAN/DAVEM"
boardingAndSeatingInfo

object (BoardingAndSeatingInfo)

מידע ספציפי לנוסע לגבי עלייה למטוס ומושבים.
reservationInfo

object (ReservationInfo)

חובה. מידע על הזמנת טיסה.
hexBackgroundColor

string

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

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 של הכיתה, אם יש כזו. אם גם תמונת ה-Hero של הכיתה לא תופיע, לא יוצג כלום.
groupingInfo

object (GroupingInfo)

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

object (PassConstraints)

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

object (SaveRestrictions)

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

string

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

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

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

enum (NotificationSettingsForUpdates)

האם עדכוני שדות באובייקט הזה יפעילו התראות. כשהערך מוגדר ל-NOTIFY, ננסה להפעיל התראה למשתמשים על עדכון השדה. ההתראות האלה יישלחו למשתמשים רק אם השדה הוא חלק מרשימת היתרים. אם הערך מוגדר כ-DO_NOT_NOTIFY או כ-NOTIFICATION_SETTINGS_UNSPECIFIED, לא תופעל התראה. ההגדרה הזו זמנית וצריך להגדיר אותה בכל בקשת PATCH או עדכון, אחרת לא תופעל התראה.
valueAddedModuleData[]

object (ValueAddedModuleData)

נתונים אופציונליים של מודול עם ערך מוסף. עד עשר באותו אובייקט.

BoardingAndSeatingInfo

ייצוג ב-JSON 
{
  "kind": string,
  "boardingGroup": string,
  "seatNumber": string,
  "seatClass": string,
  "boardingPrivilegeImage": {
    object (Image)
  },
  "boardingPosition": string,
  "sequenceNumber": string,
  "boardingDoor": enum (BoardingDoor),
  "seatAssignment": {
    object (LocalizedString)
  }
}
שדות
kind
(deprecated)

string

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

string

הערך של קבוצת העלייה למטוס (או האזור) שבה הנוסע הזה יעלה.

לדוגמה: "B"

התווית של הערך הזה תיקבע על ידי השדה boardingPolicy ב-flightClass שאליו מפנה האובייקט הזה.
seatNumber

string

הערך של מושב הנוסע. אם אין מזהה ספציפי, צריך להשתמש ב-seatAssignment במקום זאת.

לדוגמה: '25A'
seatClass

string

הערך של מחלקת המושבים.

לדוגמה: 'מחלקת תיירים' או 'מחלקת תיירים פלוס'
boardingPrivilegeImage

object (Image)

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

string

הערך של מיקום העלייה למטוס.

לדוגמה: '76'
sequenceNumber

string

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

לדוגמה: "49"
boardingDoor

enum (BoardingDoor)

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

object (LocalizedString)

המושבים שהוקצו לנוסעים. משמש כשאין מזהה ספציפי לשימוש ב-seatNumber.

לדוגמה: "assigned at gate"

BoardingDoor

טיפוסים בני מנייה (enum)
BOARDING_DOOR_UNSPECIFIED
FRONT
front

כינוי מדור קודם של FRONT. הוצא משימוש.
BACK
back

כינוי קודם של BACK. הוצא משימוש.

ReservationInfo

ייצוג ב-JSON 
{
  "kind": string,
  "confirmationCode": string,
  "eticketNumber": string,
  "frequentFlyerInfo": {
    object (FrequentFlyerInfo)
  }
}
שדות
kind
(deprecated)

string

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

string

קוד האישור הנדרש לביצוע צ'ק-אין לטיסה הזו.

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

string

מספר הכרטיס האלקטרוני.
frequentFlyerInfo

object (FrequentFlyerInfo)

פרטי החברות במועדון הנוסע המתמיד.

FrequentFlyerInfo

ייצוג ב-JSON 
{
  "kind": string,
  "frequentFlyerProgramName": {
    object (LocalizedString)
  },
  "frequentFlyerNumber": string
}
שדות
kind
(deprecated)

string

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

object (LocalizedString)

שם מועדון הנוסע המתמיד. לדוגמה: "Lufthansa Miles & More"
frequentFlyerNumber

string

מספר הנוסע המתמיד.

חובה לכל אובייקט בתצוגת עץ מסוג walletobjects#frequentFlyerInfo.

שיטות

addmessage

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

get

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

insert

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

list

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

patch

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

update

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