REST Resource: flightclass

משאב: FlightClass

ייצוג JSON
{
  "kind": string,
  "localScheduledDepartureDateTime": string,
  "localEstimatedOrActualDepartureDateTime": string,
  "localBoardingDateTime": string,
  "localScheduledArrivalDateTime": string,
  "localEstimatedOrActualArrivalDateTime": string,
  "flightHeader": {
    object (FlightHeader)
  },
  "origin": {
    object (AirportInfo)
  },
  "destination": {
    object (AirportInfo)
  },
  "flightStatus": enum (FlightStatus),
  "boardingAndSeatingPolicy": {
    object (BoardingAndSeatingPolicy)
  },
  "localGateClosingDateTime": string,
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "languageOverride": string,
  "id": string,
  "version": string,
  "issuerName": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "allowMultipleUsersPerObject": boolean,
  "homepageUri": {
    object (Uri)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "reviewStatus": enum (ReviewStatus),
  "review": {
    object (Review)
  },
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "redemptionIssuers": [
    string
  ],
  "countryCode": string,
  "heroImage": {
    object (Image)
  },
  "wordMark": {
    object (Image)
  },
  "enableSmartTap": boolean,
  "hexBackgroundColor": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "multipleDevicesAndHoldersAllowedStatus": enum (MultipleDevicesAndHoldersAllowedStatus),
  "callbackOptions": {
    object (CallbackOptions)
  },
  "securityAnimation": {
    object (SecurityAnimation)
  },
  "viewUnlockRequirement": enum (ViewUnlockRequirement),
  "appLinkData": {
    object (AppLinkData)
  }
}
שדות
kind
(deprecated)

string

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

localScheduledDepartureDateTime

string

חובה. התאריך והשעה המתוכננים שבהם המטוס צפוי לצאת מהשער (ולא על מסלול ההמראה)

הערה: השדה הזה לא יכול להשתנות קרוב מדי לשעת היציאה. כדי לקבל עדכונים בזמני יציאה (עיכובים וכו'), צריך להגדיר localEstimatedOrActualDepartureDateTime.

זהו תאריך/שעה בפורמט מורחב לפי תקן ISO 8601, ללא קיזוז. ניתן לציין זמן ברמת דיוק של עד אלפית שנייה.

למשל: 2027-03-05T06:30:00

התאריך הזה צריך להיות התאריך והשעה המקומיים של נמל התעופה (לא שעון UTC).

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

localEstimatedOrActualDepartureDateTime

string

הזמן המשוער שהמטוס מתכנן למשוך מהשער או הזמן בפועל שבו המטוס כבר נמשך מהשער. הערה: זה לא זמן ההמראה.

יש להגדיר את השדה הזה אם מתקיים לפחות אחד מהתנאים הבאים:

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

זהו תאריך/שעה בפורמט מורחב לפי תקן ISO 8601, ללא קיזוז. ניתן לציין זמן ברמת דיוק של עד אלפית שנייה.

למשל: 2027-03-05T06:30:00

התאריך הזה צריך להיות התאריך והשעה המקומיים של נמל התעופה (לא שעון UTC).

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

localBoardingDateTime

string

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

זהו תאריך/שעה בפורמט מורחב לפי תקן ISO 8601, ללא קיזוז. ניתן לציין זמן ברמת דיוק של עד אלפית שנייה.

למשל: 2027-03-05T06:30:00

התאריך הזה צריך להיות התאריך והשעה המקומיים של נמל התעופה (לא שעון UTC).

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

localScheduledArrivalDateTime

string

השעה המתוזמנת שבה המטוס מתכנן להגיע לשער היעד (לא למסלול ההמראה).

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

זהו תאריך/שעה בפורמט מורחב לפי תקן ISO 8601, ללא קיזוז. ניתן לציין זמן ברמת דיוק של עד אלפית שנייה.

למשל: 2027-03-05T06:30:00

התאריך הזה צריך להיות התאריך והשעה המקומיים של נמל התעופה (לא שעון UTC).

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

localEstimatedOrActualArrivalDateTime

string

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

יש להגדיר את השדה הזה אם מתקיים לפחות אחד מהתנאים הבאים:

  • המועד הזה שונה מהמועד שנקבע. Google תשתמש בו כדי לחשב את העיכוב.
  • המטוס כבר הגיע לשער. Google תשתמש במידע הזה כדי להודיע למשתמש שהטיסה הגיעה לשער.

זהו תאריך/שעה בפורמט מורחב לפי תקן ISO 8601, ללא קיזוז. ניתן לציין זמן ברמת דיוק של עד אלפית שנייה.

למשל: 2027-03-05T06:30:00

התאריך הזה צריך להיות התאריך והשעה המקומיים של נמל התעופה (לא שעון UTC).

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

flightHeader

object (FlightHeader)

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

origin

object (AirportInfo)

חובה. נמל התעופה שממנו יוצאת הטיסה.

destination

object (AirportInfo)

חובה. נמל התעופה שבו הטיסה נוחתת.

flightStatus

enum (FlightStatus)

הסטטוס של הטיסה הזו.

אם המדיניות לא מוגדרת, Google תחשב את הסטטוס על סמך נתונים ממקורות אחרים, כמו FlightStats וכו'.

הערה: הסטטוס שמחושב על ידי Google לא מוחזר בתשובות מה-API.

boardingAndSeatingPolicy

object (BoardingAndSeatingPolicy)

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

localGateClosingDateTime

string

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

זהו תאריך/שעה בפורמט מורחב לפי תקן ISO 8601, ללא קיזוז. ניתן לציין זמן ברמת דיוק של עד אלפית שנייה.

למשל: 2027-03-05T06:30:00

התאריך הזה צריך להיות התאריך והשעה המקומיים של נמל התעופה (לא שעון UTC).

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

classTemplateInfo

object (ClassTemplateInfo)

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

languageOverride

string

אם השדה הזה מופיע, כרטיסי עלייה למטוס שיוצגו למכשיר של המשתמש תמיד יהיו בשפה הזו. מייצג את תג השפה BCP 47. ערכים לדוגמה הם 'en-US', 'en-GB', 'de' או 'de-AT'.

id

string

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

version
(deprecated)

string (int64 format)

הוצא משימוש

issuerName

string

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

messages[]

object (Message)

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

allowMultipleUsersPerObject
(deprecated)

boolean

הוצא משימוש. במקום זאת, אתם צריכים להשתמש ב-multipleDevicesAndHoldersAllowedStatus.

homepageUri

object (Uri)

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

locations[]

object (LatLongPoint)

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

reviewStatus

enum (ReviewStatus)

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

צריך להשאיר את השדה הזה בשדה draft כשהכיתה בתהליך פיתוח. אי אפשר להשתמש במחלקה draft כדי ליצור אובייקטים.

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

כשמעדכנים כיתה שכבר approved, צריך להמשיך להגדיר את השדה הזה לערך underReview.

review

object (Review)

התגובות לבדיקה שהוגדרו על ידי הפלטפורמה כשכיתה מסומנת כ-approved או כ-rejected.

infoModuleData
(deprecated)

object (InfoModuleData)

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

imageModulesData[]

object (ImageModuleData)

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

textModulesData[]

object (TextModuleData)

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

redemptionIssuers[]

string (int64 format)

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

גם השדות enableSmartTap וברמת האובייקט smartTapRedemptionLevel צריכים להיות מוגדרים כראוי כדי שכרטיס יתמוך בתכונה 'הקשה חכמה'.

countryCode

string

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

heroImage

object (Image)

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

wordMark
(deprecated)

object (Image)

הוצא משימוש.

enableSmartTap

boolean

מזהה אם הכיתה הזו תומכת בהקשה חכמה. גם השדות redemptionIssuers וברמת האובייקט smartTapRedemptionLevel צריכים להיות מוגדרים כראוי כדי שכרטיס יתמוך בתכונה 'הקשה חכמה'.

hexBackgroundColor

string

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

localizedIssuerName

object (LocalizedString)

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

multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

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

callbackOptions

object (CallbackOptions)

אפשרויות של קריאה חוזרת (callback) שמשמשות לקריאה חוזרת למנפיק עבור כל שמירה/מחיקה של אובייקט במחלקה הזו על ידי משתמש הקצה. כל האובייקטים במחלקה הזו עומדים בדרישות להתקשרות חזרה.

securityAnimation

object (SecurityAnimation)

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

viewUnlockRequirement

enum (ViewUnlockRequirement)

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

FlightHeader

ייצוג JSON
{
  "kind": string,
  "carrier": {
    object (FlightCarrier)
  },
  "flightNumber": string,
  "operatingCarrier": {
    object (FlightCarrier)
  },
  "operatingFlightNumber": string,
  "flightNumberDisplayOverride": string
}
שדות
kind
(deprecated)

string

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

carrier

object (FlightCarrier)

מידע על חברת התעופה. זהו מאפיין חובה של flightHeader.

flightNumber

string

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

לדוגמה: "123"

operatingCarrier

object (FlightCarrier)

מידע על חברת תעופה פעילה.

operatingFlightNumber

string

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

לדוגמה: "234"

flightNumberDisplayOverride

string

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

למשל: 'XX1234 / YY576'

FlightCarrier

ייצוג JSON
{
  "kind": string,
  "carrierIataCode": string,
  "carrierIcaoCode": string,
  "airlineName": {
    object (LocalizedString)
  },
  "airlineLogo": {
    object (Image)
  },
  "airlineAllianceLogo": {
    object (Image)
  },
  "wideAirlineLogo": {
    object (Image)
  }
}
שדות
kind
(deprecated)

string

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

carrierIataCode

string

קוד IATA בן שני תווים של חברת התובלה המשווקת (בניגוד לספק התפעולי). יש לספק רק אחד מהערכים האלה או carrierIcaoCode עבור carrier ועבור operatingCarrier.

לדוגמה: "LX" ל-Swiss Air

carrierIcaoCode

string

קוד חברת ICAO בן שלושה תווים של חברת התובלה המשווקת (בניגוד לחברת התעופה התפעולית). יש לספק רק אחד מהערכים האלה או carrierIataCode עבור carrier ועבור operatingCarrier.

למשל: "EZY" ל-Easy Jet

airlineName

object (LocalizedString)

שם מותאם לשוק המקומי של חברת התעופה שצוינה על ידי leadIataCode. אם המדיניות לא מוגדרת, issuerName או localizedIssuerName מ-FlightClass ישמשו למטרות תצוגה.

לדוגמה: "Swiss Air" ל-"LX"

AirportInfo

ייצוג JSON
{
  "kind": string,
  "airportIataCode": string,
  "terminal": string,
  "gate": string,
  "airportNameOverride": {
    object (LocalizedString)
  }
}
שדות
kind
(deprecated)

string

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

airportIataCode

string

קוד IATA בן שלושה תווים. זהו שדה חובה עבור origin ו-destination.

לדוגמה: "SFO"

terminal

string

שם הטרמינל. לדוגמה: "INTL" או "I"

gate

string

שם השער. לדוגמה: "B59" או 59

airportNameOverride

object (LocalizedString)

שדה אופציונלי שמחליף את שם העיר של נמל התעופה שהוגדר על ידי IATA. כברירת מחדל, Google משתמשת בairportIataCode שסופקה וממפה אותו לשם העיר הרשמי של נמל התעופה כפי שהוגדר על ידי IATA.

את השמות הרשמיים של הערים של נמלי התעופה IATA אפשר למצוא באתר של השמות של ערי נמלי התעופה IATA. לדוגמה, עבור קוד IATA של נמל התעופה 'LTN', אתר IATA מציין שעיר שדה התעופה המתאימה היא 'לונדון'.

אם השדה הזה לא מאוכלס, Google תציג את הערך 'לונדון'.

עם זאת, אכלוס השדה הזה בשם מותאם אישית (למשל: "לונדון לוטון") יבטל אותו.

FlightStatus

טיפוסים בני מנייה (enum)
FLIGHT_STATUS_UNSPECIFIED
SCHEDULED הטיסה יוצאת בזמן, מוקדם או מתעכבת.
scheduled

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

ACTIVE הטיסה מתבצעת (מס, המראה, נחיתה, מוטוס).
active

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

LANDED הטיסה נחתה ביעד המקורי.
landed

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

CANCELLED הטיסה בוטלה.
cancelled

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

REDIRECTED הטיסה מוטלת באוויר, אבל היא עוברת לשדה תעופה אחר מזה של היעד המקורי.
redirected

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

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

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

BoardingAndSeatingPolicy

ייצוג JSON
{
  "kind": string,
  "boardingPolicy": enum (BoardingPolicy),
  "seatClassPolicy": enum (SeatClassPolicy)
}
שדות
kind
(deprecated)

string

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

boardingPolicy

enum (BoardingPolicy)

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

seatClassPolicy

enum (SeatClassPolicy)

מדיניות מושבים שקובעת איך אנחנו מציגים את סיווג המושבים. אם המדיניות לא מוגדרת, Google תשתמש בערך cabinBased כברירת מחדל.

BoardingPolicy

טיפוסים בני מנייה (enum)
BOARDING_POLICY_UNSPECIFIED
ZONE_BASED
zoneBased

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

GROUP_BASED
groupBased

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

BOARDING_POLICY_OTHER
boardingPolicyOther

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

SeatClassPolicy

טיפוסים בני מנייה (enum)
SEAT_CLASS_POLICY_UNSPECIFIED
CABIN_BASED
cabinBased

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

CLASS_BASED
classBased

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

TIER_BASED
tierBased

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

SEAT_CLASS_POLICY_OTHER
seatClassPolicyOther

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

שיטות

addmessage

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

get

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

insert

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

list

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

patch

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

update

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