משאב: FlightObject
ייצוג ב-JSON |
---|
{ "kind": string, "classReference": { object ( |
שדות | |
---|---|
kind |
מזהה את סוג המשאב. ערך: המחרוזת הקבועה |
classReference |
עותק של השדות שעברו בירושה מכיתה ההורה. השדות האלה מאוחזרים במהלך קריאה מסוג GET. |
passengerName |
חובה. שם הנוסע כפי שהוא מופיע בכרטיס העלייה למטוס. לדוגמה: "Dave M Gahan" או "Gahan/Dave" או "GAHAN/DAVEM" |
boardingAndSeatingInfo |
מידע ספציפי לנוסעים לגבי העלייה למטוס והושבה. |
reservationInfo |
חובה. מידע על הזמנת טיסה. |
securityProgramLogo |
תמונה של תוכנית האבטחה שחלה על הנוסע. |
hexBackgroundColor |
צבע הרקע של הכרטיס. אם לא תגדירו צבע, המערכת תשתמש בצבע השולט בתמונה הראשית. אם לא תגדירו תמונה ראשית, המערכת תשתמש בצבע השולט בלוגו. הפורמט הוא #rrggbb, כאשר rrggbb הוא טריופל RGB ב-hex, למשל |
id |
חובה. המזהה הייחודי של אובייקט. המזהה הזה חייב להיות ייחודי בכל האובייקטים של מנפיק. הערך צריך להיות בפורמט issuer ID.identifier, כאשר המזהה הראשון מונפק על ידי Google והשני נבחר על ידכם. המזהה הייחודי צריך לכלול רק תווים אלפאנומריים, '.', '_' או '-'. |
classId |
חובה. הכיתה שמשויכת לאובייקט הזה. הכיתה צריכה להיות מאותו סוג כמו האובייקט הזה, היא כבר צריכה להתקיים והיא צריכה להיות מאושרת. מזהי הכיתות צריכים להיות בפורמט issuer ID.identifier, כאשר המזהה הראשון מונפק על ידי Google והשני נבחר על ידכם. |
version |
הוצא משימוש |
state |
חובה. המצב של האובייקט. השדה הזה משמש לקביעת האופן שבו אובייקט מוצג באפליקציה. לדוגמה, אובייקט |
barcode |
סוג הברקוד והערך שלו. |
messages[] |
מערך של הודעות שמוצגות באפליקציה. כל המשתמשים באובייקט הזה יקבלו את ההודעות המשויכות אליו. המספר המקסימלי של השדות האלה הוא 10. |
validTimeInterval |
פרק הזמן שבו האובייקט יהיה |
locations[] |
הערה: בשלב הזה אין תמיכה בשדה הזה כדי להפעיל התראות גיאוגרפיות. |
hasUsers |
מציין אם יש לאובייקט משתמשים. השדה הזה מוגדר על ידי הפלטפורמה. |
smartTapRedemptionValue |
הערך שיישלח לאובייקט הזה למסוף מאושר של Smart Tap באמצעות NFC. כדי שהכרטיס יתמוך בתכונה 'הקשה חכמה', צריך להגדיר גם את השדות |
hasLinkedDevice |
אם האובייקט הזה מקושר כרגע למכשיר אחד. השדה הזה מוגדר על ידי הפלטפורמה כשמשתמש שומר את האובייקט ומקשר אותו למכשיר שלו. מיועד לשימוש של שותפים נבחרים. לקבלת מידע נוסף, אפשר לפנות לתמיכה. |
disableExpirationNotification |
מציין אם צריך לדכא את ההתראות באופן מפורש. אם השדה הזה מוגדר כ-true, ללא קשר לשדה בשלב זה אפשר להגדיר את האפשרות הזו רק לטיסות. |
infoModuleData |
הוצא משימוש. במקום זאת, צריך להשתמש ב-textModulesData. |
imageModulesData[] |
נתוני מודול התמונה. המספר המקסימלי של השדות האלה שמוצגים הוא 1 ברמת האובייקט ו-1 ברמת אובייקט הכיתה. |
textModulesData[] |
נתונים של מודול טקסט. אם מוגדרים גם נתונים של מודול טקסט בכיתה, יוצגו שניהם. המספר המקסימלי של השדות האלה שמוצגים הוא 10 מהאובייקט ו-10 מהכיתה. |
linksModuleData |
נתוני המודול 'קישורים'. אם הנתונים של מודול הקישורים מוגדרים גם בכיתה, יוצגו שניהם. |
appLinkData |
קישור אופציונלי לאפליקציה או לאתר שיוצג כלחצן בחזית הכרטיס. אם יסופקו נתוני AppLinkData לסיווג המתאים, יוצגו רק נתוני AppLinkData של האובייקט. |
rotatingBarcode |
הסוג והערך של הברקוד המסתובב. |
heroImage |
תמונה אופציונלית של באנר שמוצגת בחזית הכרטיס. אם לא תהיה תמונה כזו, תוצג תמונה ראשית של הכיתה, אם יש כזו. אם גם תמונת ה-Hero של הכיתה לא תופיע, לא יוצג כלום. |
groupingInfo |
מידע שקובע את אופן הקיבוץ של הכרטיסים. |
passConstraints |
מעבירים את האילוצים של האובייקט. כולל הגבלת התנהגויות של NFC וצילומי מסך. |
saveRestrictions |
הגבלות על האובייקט שצריך לאמת לפני שהמשתמש ינסה לשמור את הכרטיס. חשוב לזכור שההגבלות האלה יחולו רק במהלך זמן השמירה. אם ההגבלות השתנו אחרי שהמשתמש שמר את הכרטיס, ההגבלות החדשות לא יחולו על כרטיס שכבר נשמר. |
linkedObjectIds[] |
linkedObjectIds היא רשימה של אובייקטים אחרים, כמו כרטיס אירוע, כרטיס מועדון, מבצע, כרטיס גנרי, כרטיס מתנה, כרטיס לתחבורה ציבורית וכרטיס עלייה למטוס, שצריך לצרף באופן אוטומטי לאובייקט הטיסה הזה. אם משתמש שמר את כרטיס העלייה למטוס, מזהי ה-linkedObjectIds האלה יועברו באופן אוטומטי לארנק של המשתמש (אלא אם הוא השבית את ההגדרה לקבלת כרטיסים מקושרים כאלה). חשוב לוודא שהאובייקטים שמופיעים ב-linkedObjectIds כבר הוכנסו – אחרת הקריאות ייכשל. אחרי שמקשרים אובייקטים, אי אפשר לבטל את הקישור שלהם. אי אפשר לקשר אובייקטים ששייכים למנפיק אחר. יש מגבלה על מספר האובייקטים שאפשר לקשר לאובייקט יחיד. אחרי שמגיעים למגבלה, המערכת תתעלם בשקט מאובייקטים מקושרים חדשים בשיחה. מזהי אובייקטים צריכים להיות בפורמט issuer ID.identifier, כאשר הראשון מונפק על ידי Google והשני נבחר על ידכם. |
notifyPreference |
האם עדכוני שדות באובייקט הזה יפעילו התראות. כשהערך מוגדר ל-NOTIFY, אנחנו מנסים להפעיל התראה למשתמשים על עדכון השדה. ההתראות האלה יישלחו למשתמשים רק אם השדה נכלל ברשימת ההיתרים. אם הערך מוגדר כ-DO_NOT_NOTIFY או כ-NOTIFICATION_SETTINGS_UNSPECIFIED, לא תופעל התראה. ההגדרה הזו היא זמנית וצריך להגדיר אותה בכל בקשת PATCH או UPDATE, אחרת לא תופעל התראה. |
valueAddedModuleData[] |
נתונים אופציונליים של מודול עם ערך מוסף. עד עשר באותו אובייקט. |
BoardingAndSeatingInfo
ייצוג ב-JSON |
---|
{ "kind": string, "boardingGroup": string, "seatNumber": string, "seatClass": string, "boardingPrivilegeImage": { object ( |
שדות | |
---|---|
kind |
מזהה את סוג המשאב. ערך: המחרוזת הקבועה |
boardingGroup |
הערך של קבוצת העלייה למטוס (או האזור) שבה הנוסע הזה יעלה. לדוגמה: "B" התווית של הערך הזה תיקבע על ידי השדה |
seatNumber |
הערך של מושב הנוסע. אם אין מזהה ספציפי, צריך להשתמש ב- לדוגמה: '25A' |
seatClass |
הערך של מחלקת המושבים. לדוגמה: 'מחלקת תיירים' או 'מחלקת תיירים פלוס' |
boardingPrivilegeImage |
תמונה קטנה שמופיעה מעל הברקוד להצגת הכרטיס. חברות התעופה יכולות להשתמש בו כדי להעביר לכם מידע על הרשאות מיוחדות לעלייה למטוס. אם הוגדר גם הלוגו של תוכנית האבטחה, יכול להיות שהתמונה הזו תעובד לצד הלוגו של תוכנית האבטחה הזו. |
boardingPosition |
הערך של מיקום העלייה למטוס. לדוגמה: '76' |
sequenceNumber |
מספר הסדרה בכרטיס העלייה למטוס. בדרך כלל, הסדר הזה תואם לסדר שבו הנוסעים נכנסו למטוס. חברת התעופה עשויה להשתמש במספר הזה כדי לאפשר עלייה ידנית למטוס ולתגים של מזוודות. לדוגמה: '49' |
boardingDoor |
מגדירים את השדה הזה רק אם יש יותר מדלת אחת או יותר גשר לעלייה למטוס בטיסה הזו, ואתם רוצים להדפיס במפורש את מיקום הדלת בכרטיס העלייה למטוס. רוב חברות התעופה מפנות את הנוסעים לדלת או לגשר הנכונים על ידי ציון הדלתות או הגשרים באמצעות |
seatAssignment |
המושבים שהוקצו לנוסעים. משמש כשאין מזהה ספציפי לשימוש ב- לדוגמה: "assigned at gate" |
BoardingDoor
טיפוסים בני מנייה (enum) | |
---|---|
BOARDING_DOOR_UNSPECIFIED |
|
FRONT |
|
front |
כתובת אימייל חלופית מדור קודם של |
BACK |
|
back |
כתובת אימייל חלופית מדור קודם של |
ReservationInfo
ייצוג ב-JSON |
---|
{
"kind": string,
"confirmationCode": string,
"eticketNumber": string,
"frequentFlyerInfo": {
object ( |
שדות | |
---|---|
kind |
מזהה את סוג המשאב. ערך: המחרוזת הקבועה |
confirmationCode |
קוד האישור הנדרש לביצוע צ'ק-אין לטיסה הזו. זהו המספר שהנוסע מזין בקיוסק בנמל התעופה כדי לחפש את הטיסה ולהדפיס כרטיס עלייה למטוס. |
eticketNumber |
מספר הכרטיס האלקטרוני. |
frequentFlyerInfo |
פרטי החברות במועדון הנוסע המתמיד. |
FrequentFlyerInfo
ייצוג ב-JSON |
---|
{
"kind": string,
"frequentFlyerProgramName": {
object ( |
שדות | |
---|---|
kind |
מזהה את סוג המשאב. ערך: המחרוזת הקבועה |
frequentFlyerProgramName |
שם מועדון הנוסע המתמיד. לדוגמה: "Lufthansa Miles & More" |
frequentFlyerNumber |
מספר הנוסע המתמיד. חובה לכל אובייקט בתצוגת עץ מסוג |
Methods |
|
---|---|
|
הוספת הודעה לאובייקט הטיסה שמוזכר במזהה האובייקט הנתון. |
|
הפונקציה מחזירה את אובייקט הטיסה עם מזהה האובייקט שצוין. |
|
הוספת אובייקט טיסה עם המזהה והמאפיינים שצוינו. |
|
הפונקציה מחזירה רשימה של כל אובייקטי הטיסות למזהה מנפיק נתון. |
|
הקוד מעדכן את אובייקט הטיסה שמוזכר במזהה האובייקט הנתון. |
|
הקוד מעדכן את אובייקט הטיסה שמוזכר במזהה האובייקט הנתון. |