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),
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "appLinkData": {
    object (AppLinkData)
  },
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
שדות
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 ב-linksModuleData (כשאובייקט מנוהל, קישור לדף הבית מוצג במקום שנחשב בדרך כלל לקטע linksModuleData של האובייקט).
locations[]
(deprecated)

object (LatLongPoint)

הערה: בשלב הזה אין תמיכה בשדה הזה להפעלת התראות גיאוגרפיות.
reviewStatus

enum (ReviewStatus)

חובה. הסטטוס של הכיתה. אפשר להגדיר את השדה הזה לערך draft או underReview באמצעות קריאות ה-API insert,‏ patch או update. אחרי שסטטוס הבדיקה משתנה מ-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

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

object (LocalizedString)

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

enum (MultipleDevicesAndHoldersAllowedStatus)

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

object (CallbackOptions)

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

object (SecurityAnimation)

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

enum (ViewUnlockRequirement)

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

enum (NotificationSettingsForUpdates)

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

object (ValueAddedModuleData)

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

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

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

למשל: '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 airport city names. לדוגמה, לפי קוד ה-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

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