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

groupingInfo

object (GroupingInfo)

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

passConstraints

object (PassConstraints)

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

saveRestrictions

object (SaveRestrictions)

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

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

טיפוסים בני מנייה (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 & עוד'

frequentFlyerNumber

string

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

נדרש לכל אובייקט מקונן מסוג walletobjects#frequentFlyerInfo.

שיטות

addmessage

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

get

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

insert

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

list

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

patch

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

update

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