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)
  }
}
שדות
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

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

groupingInfo

object (GroupingInfo)

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

passConstraints

object (PassConstraints)

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

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

הערך של מחלקה.

לדוגמה: "Economy" או "Economy Plus"

boardingPrivilegeImage

object (Image)

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

boardingPosition

string

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

לדוגמה: "76"

sequenceNumber

string

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

לדוגמה: "49"

boardingDoor

enum (BoardingDoor)

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

seatAssignment

object (LocalizedString)

בחירת מושב הנוסע. לשימוש כשאין מזהה ספציפי לשימוש ב-seatNumber.

למשל: "הוקצתה בשער"

BoardingDoor

טיפוסים בני מנייה (enums)
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

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