REST Resource: transitobject

משאב: TransitObject

ייצוג ב-JSON
{
  "classReference": {
    object (TransitClass)
  },
  "ticketNumber": string,
  "passengerType": enum (PassengerType),
  "passengerNames": string,
  "tripId": string,
  "ticketStatus": enum (TicketStatus),
  "customTicketStatus": {
    object (LocalizedString)
  },
  "concessionCategory": enum (ConcessionCategory),
  "customConcessionCategory": {
    object (LocalizedString)
  },
  "ticketRestrictions": {
    object (TicketRestrictions)
  },
  "purchaseDetails": {
    object (PurchaseDetails)
  },
  "ticketLeg": {
    object (TicketLeg)
  },
  "ticketLegs": [
    {
      object (TicketLeg)
    }
  ],
  "hexBackgroundColor": string,
  "tripType": enum (TripType),
  "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)
  },
  "activationStatus": {
    object (ActivationStatus)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "deviceContext": {
    object (DeviceContext)
  },
  "heroImage": {
    object (Image)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
שדות
classReference

object (TransitClass)

עותק של השדות שעברו בירושה מכיתה ההורה. השדות האלה מאוחזרים במהלך קריאה מסוג GET.

ticketNumber

string

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

passengerType

enum (PassengerType)

מספר הנוסעים.

passengerNames

string

השמות של הנוסעים שהכרטיס הוקצה להם. השדה passengerType שלמעלה נועד לספק ל-Google הקשר לגבי השדה הזה.

tripId

string

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

ticketStatus

enum (TicketStatus)

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

customTicketStatus

object (LocalizedString)

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

concessionCategory

enum (ConcessionCategory)

קטגוריית ההנחה של הכרטיס.

customConcessionCategory

object (LocalizedString)

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

ticketRestrictions

object (TicketRestrictions)

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

purchaseDetails

object (PurchaseDetails)

פרטי הרכישה של הכרטיס הזה.

ticketLeg

object (TicketLeg)

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

ticketLegs[]

object (TicketLeg)

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

hexBackgroundColor

string

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

tripType

enum (TripType)

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

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[]
(deprecated)

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 מהכיתה.

activationStatus

object (ActivationStatus)

סטטוס ההפעלה של האובייקט. חובה אם בכיתה מוגדר activationOptions.

rotatingBarcode

object (RotatingBarcode)

הסוג והערך של הברקוד המסתובב.

deviceContext

object (DeviceContext)

ההקשר של המכשיר שמשויך לאובייקט.

heroImage

object (Image)

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

groupingInfo

object (GroupingInfo)

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

passConstraints

object (PassConstraints)

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

saveRestrictions

object (SaveRestrictions)

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

linkedObjectIds[]

string

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

חשוב לוודא שהאובייקטים שמופיעים ב-linkedObjectIds כבר הוכנסו – אחרת הקריאות ייכשל. אחרי שמקשרים אובייקטים, אי אפשר לבטל את הקישור שלהם. אי אפשר לקשר אובייקטים ששייכים למנפיק אחר. יש מגבלה על מספר האובייקטים שאפשר לקשר לאובייקט יחיד. אחרי שמגיעים למגבלה, המערכת תתעלם בשקט מאובייקטים מקושרים חדשים בשיחה.

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

notifyPreference

enum (NotificationSettingsForUpdates)

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

valueAddedModuleData[]

object (ValueAddedModuleData)

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

PassengerType

טיפוסים בני מנייה (enum)
PASSENGER_TYPE_UNSPECIFIED
SINGLE_PASSENGER
singlePassenger

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

MULTIPLE_PASSENGERS
multiplePassengers

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

TicketStatus

טיפוסים בני מנייה (enum)
TICKET_STATUS_UNSPECIFIED
USED
used

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

REFUNDED
refunded

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

EXCHANGED
exchanged

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

ConcessionCategory

טיפוסים בני מנייה (enum)
CONCESSION_CATEGORY_UNSPECIFIED
ADULT
adult

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

CHILD
child

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

SENIOR
senior

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

TicketRestrictions

ייצוג ב-JSON
{
  "routeRestrictions": {
    object (LocalizedString)
  },
  "routeRestrictionsDetails": {
    object (LocalizedString)
  },
  "timeRestrictions": {
    object (LocalizedString)
  },
  "otherRestrictions": {
    object (LocalizedString)
  }
}
שדות
routeRestrictions

object (LocalizedString)

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

routeRestrictionsDetails

object (LocalizedString)

פרטים נוספים על routeRestrictions שלמעלה.

timeRestrictions

object (LocalizedString)

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

otherRestrictions

object (LocalizedString)

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

PurchaseDetails

ייצוג ב-JSON
{
  "purchaseReceiptNumber": string,
  "purchaseDateTime": string,
  "accountId": string,
  "confirmationCode": string,
  "ticketCost": {
    object (TicketCost)
  }
}
שדות
purchaseReceiptNumber

string

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

purchaseDateTime

string

תאריך הרכישה או השעה של הכרטיס.

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

לדוגמה:

הערך של 1985-04-12T23:20:50.52Z יהיה 20 דקות ו-50.52 שניות אחרי השעה ה-23 ב-12 באפריל 1985 לפי שעון UTC.

הערך של 1985-04-12T19:20:50.52-04:00 יהיה 20 דקות ו-50.52 שניות אחרי השעה ה-19 ב-12 באפריל 1985, 4 שעות לפני שעון UTC (אותה נקודה בזמן כמו בדוגמה שלמעלה). אם האירוע היה בניו יורק, זה היה שווה ערך לשעון קיץ החוף המזרחי (EDT). חשוב לזכור שההיסט משתנה באזורים שבהם משתמשים בשעון קיץ, בהתאם לזמן בשנה.

הערך של 1985-04-12T19:20:50.52 יהיה 20 דקות ו-50.52 שניות אחרי השעה 19:00 ב-12 באפריל 1985, ללא פרטי הפרש זמן.

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

accountId

string

מזהה החשבון שבו השתמשתם לרכישת הכרטיס.

confirmationCode

string

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

ticketCost

object (TicketCost)

עלות הכרטיס.

TicketCost

ייצוג ב-JSON
{
  "faceValue": {
    object (Money)
  },
  "purchasePrice": {
    object (Money)
  },
  "discountMessage": {
    object (LocalizedString)
  }
}
שדות
faceValue

object (Money)

הערך הנקוב של הכרטיס.

purchasePrice

object (Money)

מחיר הרכישה בפועל של הכרטיס, אחרי מסים ו/או הנחות.

discountMessage

object (LocalizedString)

הודעה שמתארת את סוג ההנחה שהוחל.

TicketLeg

ייצוג ב-JSON
{
  "originStationCode": string,
  "originName": {
    object (LocalizedString)
  },
  "destinationStationCode": string,
  "destinationName": {
    object (LocalizedString)
  },
  "departureDateTime": string,
  "arrivalDateTime": string,
  "fareName": {
    object (LocalizedString)
  },
  "carriage": string,
  "platform": string,
  "zone": string,
  "ticketSeat": {
    object (TicketSeat)
  },
  "ticketSeats": [
    {
      object (TicketSeat)
    }
  ],
  "transitOperatorName": {
    object (LocalizedString)
  },
  "transitTerminusName": {
    object (LocalizedString)
  }
}
שדות
originStationCode

string

קוד התחנה המקורית. השדה הזה נדרש אם השדה destinationStationCode קיים או אם השדה originName לא קיים.

originName

object (LocalizedString)

השם של תחנת המוצא. השדה הזה נדרש אם השדה desinationName קיים או אם השדה originStationCode לא קיים.

destinationStationCode

string

קוד תחנת היעד.

destinationName

object (LocalizedString)

שם היעד.

departureDateTime

string

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

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

לדוגמה:

הערך של 1985-04-12T23:20:50.52Z יהיה 20 דקות ו-50.52 שניות אחרי השעה ה-23 ב-12 באפריל 1985 לפי שעון UTC.

הערך של 1985-04-12T19:20:50.52-04:00 יהיה 20 דקות ו-50.52 שניות אחרי השעה ה-19 ב-12 באפריל 1985, 4 שעות לפני שעון UTC (אותה נקודה בזמן כמו בדוגמה שלמעלה). אם האירוע היה בניו יורק, זה היה שווה ערך לשעון קיץ החוף המזרחי (EDT). חשוב לזכור שההיסט משתנה באזורים שבהם משתמשים בשעון קיץ, בהתאם לזמן בשנה.

הערך של 1985-04-12T19:20:50.52 יהיה 20 דקות ו-50.52 שניות אחרי השעה 19:00 ב-12 באפריל 1985, ללא פרטי הפרש זמן.

החלק של התאריך/השעה בלי הפרש השעות נחשב ל'תאריך/שעה מקומיים'. התאריך והשעה צריכים להיות לפי השעון המקומי בתחנת המוצא. לדוגמה, אם היציאה מתרחשת בשעה ה-20 ב-5 ביוני 2018 בתחנת המוצא, החלק של התאריך/השעה המקומיים צריך להיות 2018-06-05T20:00:00. אם התאריך/השעה המקומיים בתחנת המוצא הם 4 שעות לפני שעון UTC, יכול להיות שיתווסף שינוי של -04:00.

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

arrivalDateTime

string

התאריך והשעה של ההגעה.

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

לדוגמה:

הערך של 1985-04-12T23:20:50.52Z יהיה 20 דקות ו-50.52 שניות אחרי השעה ה-23 ב-12 באפריל 1985 לפי שעון UTC.

הערך של 1985-04-12T19:20:50.52-04:00 יהיה 20 דקות ו-50.52 שניות אחרי השעה ה-19 ב-12 באפריל 1985, 4 שעות לפני שעון UTC (אותה נקודה בזמן כמו בדוגמה שלמעלה). אם האירוע היה בניו יורק, זה היה שווה ערך לשעון קיץ החוף המזרחי (EDT). חשוב לזכור שההיסט משתנה באזורים שבהם משתמשים בשעון קיץ, בהתאם לזמן בשנה.

הערך של 1985-04-12T19:20:50.52 יהיה 20 דקות ו-50.52 שניות אחרי השעה 19:00 ב-12 באפריל 1985, ללא פרטי הפרש זמן.

החלק של התאריך/השעה בלי הפרש השעות נחשב ל'תאריך/שעה מקומיים'. התאריך/השעה צריכים להיות לפי השעון המקומי בתחנת היעד. לדוגמה, אם האירוע מתרחש בשעה ה-20 ב-5 ביוני 2018 בתחנת היעד, החלק של התאריך/השעה המקומיים צריך להיות 2018-06-05T20:00:00. אם התאריך/השעה המקומיים בתחנת היעד הם 4 שעות לפני UTC, יכול להיות שיתווסף שינוי של -04:00.

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

fareName

object (LocalizedString)

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

carriage

string

השם או המספר של הרכבת או הספינה שהנוסע צריך לעלות עליהן.

platform

string

הרציף או השער שבהם הנוסע יכול לעלות לרכבת.

zone

string

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

ticketSeat

object (TicketSeat)

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

ticketSeats[]

object (TicketSeat)

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

transitOperatorName

object (LocalizedString)

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

transitTerminusName

object (LocalizedString)

תחנת הטרמינל או היעד של הרכבת/האוטובוס וכו'

TicketSeat

ייצוג ב-JSON
{
  "fareClass": enum (FareClass),
  "customFareClass": {
    object (LocalizedString)
  },
  "coach": string,
  "seat": string,
  "seatAssignment": {
    object (LocalizedString)
  }
}
שדות
fareClass

enum (FareClass)

קבוצת המחירים של המושב שרכשתם.

customFareClass

object (LocalizedString)

סיווג של מחיר נסיעה בהתאמה אישית שישמש אם לא חל fareClass. אסור להגדיר גם את fareClass וגם את customFareClass.

coach

string

המזהה של קרון הרכבת שבו נמצא המושב שרכשתם. לדוגמה: ‎"10"‎

seat

string

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

seatAssignment

object (LocalizedString)

המושבים שהוקצו לנוסעים. לדוגמה: 'no specific seat'. משמש כשאין מזהה ספציפי לשימוש ב-seat.

FareClass

טיפוסים בני מנייה (enum)
FARE_CLASS_UNSPECIFIED
ECONOMY
economy

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

FIRST
first

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

BUSINESS
business

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

TripType

טיפוסים בני מנייה (enum)
TRIP_TYPE_UNSPECIFIED
ROUND_TRIP
roundTrip

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

ONE_WAY
oneWay

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

ActivationStatus

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

ייצוג ב-JSON
{
  "state": enum (State)
}
שדות
state

enum (State)

מדינה

טיפוסים בני מנייה (enum)
UNKNOWN_STATE
NOT_ACTIVATED לא הופעל, זהו סטטוס ברירת המחדל
not_activated

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

ACTIVATED התכונה הופעלה
activated

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

DeviceContext

ההקשר של המכשיר שמשויך לאובייקט.

ייצוג ב-JSON
{
  "deviceToken": string
}
שדות
deviceToken

string

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

Methods

addmessage

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

get

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

insert

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

list

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

patch

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

update

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