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. מנפיקי שוברי המימוש מזוהים לפי מזהה המנפיק שלהם. למנפיקים של שוברי מימוש צריך להיות מוגדר לפחות מפתח אחד של Smart Tap.

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

countryCode

string

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

heroImage

object (Image)

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

wordMark
(deprecated)

object (Image)

הוצא משימוש.

enableSmartTap

boolean

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

hexBackgroundColor

string

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

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

לדוגמה: "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)

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

Methods

addmessage

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

get

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

insert

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

list

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

patch

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

update

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