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)
}
שדות
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 על סמך שדה התעופה שממנו יוצאת הטיסה.

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

string

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

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

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

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

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

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

string

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

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

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

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

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

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

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

string

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

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

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

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

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

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

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

אם לא קובעים במדיניות הזו שום הגדרה, 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 ב- linksModuleData (כשאובייקט עובר עיבוד, מוצג קישור לדף הבית במה שנחשב בדרך כלל כמקטע linksModuleData של האובייקט).
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)

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

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

string

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

object (Image)

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

object (Image)

הוּצא משימוש.
enableSmartTap

boolean

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

string

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

שם מותאם לשוק המקומי של חברת התעופה, שצוין על ידי providerIataCode. אם המדיניות לא מוגדרת, 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

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

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

כתובת אימייל חלופית מדור קודם של ZONE_BASED. הוּצא משימוש.
GROUP_BASED
groupBased

כתובת אימייל חלופית מדור קודם של GROUP_BASED. הוּצא משימוש.
BOARDING_POLICY_OTHER
boardingPolicyOther

כתובת אימייל חלופית מדור קודם של BOARDING_POLICY_OTHER. הוּצא משימוש.

SeatClassPolicy

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

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