REST Resource: flightobject

منبع: FlightObject

نمایندگی JSON 
{
  "kind": string,
  "classReference": {
    object (FlightClass)
  },
  "passengerName": string,
  "boardingAndSeatingInfo": {
    object (BoardingAndSeatingInfo)
  },
  "reservationInfo": {
    object (ReservationInfo)
  },
  "securityProgramLogo": {
    object (Image)
  },
  "hexBackgroundColor": string,
  "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)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "heroImage": {
    object (Image)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
فیلدها
kind
(deprecated)

string

مشخص می کند که این چه نوع منبعی است. مقدار: رشته ثابت "walletobjects#flightObject" .

class Reference

object ( FlightClass )

یک کپی از فیلدهای ارثی کلاس والد. این فیلدها در طول GET بازیابی می شوند.

passenger Name

string

مورد نیاز. نام مسافر همانطور که در کارت پرواز ظاهر می شود.

به عنوان مثال: "Dave M Gahan" یا "Gahan/Dave" یا "GAHAN/DAVEM"

boarding And Seating Info

object ( BoardingAndSeatingInfo )

اطلاعات خاص مسافر در مورد سوار شدن و نشستن.

reservation Info

object ( ReservationInfo )

مورد نیاز. اطلاعات در مورد رزرو پرواز

hex Background Color

string

رنگ پس زمینه کارت اگر تنظیم نشده باشد از رنگ غالب تصویر قهرمان استفاده می شود و اگر تصویر قهرمان تنظیم نشده باشد از رنگ غالب لوگو استفاده می شود. قالب # rrggbb است که در آن rrggbb یک سه گانه RGB هگز است، مانند #ffcc00 . همچنین می توانید از نسخه کوتاه سه گانه RGB که # rgb است، مانند #fc0 استفاده کنید.

id

string

مورد نیاز. شناسه منحصر به فرد برای یک شی. این شناسه باید در همه اشیاء صادرکننده منحصر به فرد باشد. این مقدار باید از issuer ID قالب پیروی کند. identifier جایی که اولی توسط Google صادر می شود و دومی توسط شما انتخاب می شود. شناسه منحصر به فرد باید فقط شامل کاراکترهای الفبای عددی، '.'، '_' یا '-' باشد.

class Id

string

مورد نیاز. کلاس مرتبط با این شی. کلاس باید از همان نوع این شی باشد، باید از قبل وجود داشته باشد و باید تایید شود.

شناسه‌های کلاس باید از فرمت issuer ID پیروی کنند. identifier جایی که اولی توسط Google صادر می شود و دومی توسط شما انتخاب می شود.

version
(deprecated)

string ( int64 format)

منسوخ شده است

state

enum ( State )

مورد نیاز. وضعیت جسم. این فیلد برای تعیین نحوه نمایش یک شی در برنامه استفاده می شود. به عنوان مثال، یک شی inactive به بخش "گذرنامه های منقضی" منتقل می شود.

barcode

object ( Barcode )

نوع و مقدار بارکد

messages[]

object ( Message )

مجموعه ای از پیام ها در برنامه نمایش داده می شود. همه کاربران این شیء پیام های مرتبط با آن را دریافت خواهند کرد. حداکثر تعداد این فیلدها 10 عدد می باشد.

valid Time Interval

object ( TimeInterval )

مدت زمانی که این شی active خواهد بود و می توان از شی استفاده کرد. پس از سپری شدن این بازه زمانی، وضعیت یک شی به expired تغییر می کند.

locations[]
(deprecated)

object ( LatLongPoint )

توجه: این فیلد در حال حاضر برای فعال کردن اعلان‌های جغرافیایی پشتیبانی نمی‌شود.

has Users

boolean

نشان می دهد که آیا شیء کاربر دارد یا خیر. این فیلد توسط پلتفرم تنظیم شده است.

smart Tap Redemption Value

string

مقداری که برای این شیء از طریق NFC به پایانه تأیید شده Smart Tap منتقل می شود. فیلدهای سطح کلاس enableSmartTap و redemptionIssuers نیز باید به درستی تنظیم شوند تا پاس از Smart Tap پشتیبانی کند. فقط کاراکترهای ASCII پشتیبانی می شوند.

has Linked Device

boolean

آیا این شی در حال حاضر به یک دستگاه مرتبط است یا خیر. این فیلد زمانی توسط پلتفرم تنظیم می شود که کاربر شی را ذخیره می کند و آن را به دستگاه خود پیوند می دهد. برای استفاده توسط شرکای منتخب در نظر گرفته شده است. برای اطلاعات بیشتر با پشتیبانی تماس بگیرید.

disable Expiration Notification

boolean

نشان می دهد که آیا اعلان ها باید صریحاً سرکوب شوند یا خیر. اگر این فیلد روی درست تنظیم شود، صرف نظر از فیلد messages ، اعلان‌های انقضا به کاربر سرکوب می‌شوند. به طور پیش فرض، این فیلد روی false تنظیم شده است.

در حال حاضر، این فقط برای پروازها قابل تنظیم است.

info Module Data

object ( InfoModuleData )

منسوخ شده است. به جای آن از textModulesData استفاده کنید.

image Modules Data[]

object ( ImageModuleData )

داده های ماژول تصویر حداکثر تعداد این فیلدهای نمایش داده شده 1 از سطح شی و 1 برای سطح شیء کلاس است.

text Modules Data[]

object ( TextModuleData )

داده های ماژول متنی اگر داده های ماژول متنی نیز روی کلاس تعریف شده باشد، هر دو نمایش داده می شوند. حداکثر تعداد این فیلدهای نمایش داده شده 10 از شی و 10 از کلاس است.

rotating Barcode

object ( RotatingBarcode )

نوع و مقدار بارکد چرخشی

hero Image

object ( Image )

تصویر بنر اختیاری در جلوی کارت نمایش داده می شود. اگر هیچ کدام وجود نداشته باشد، تصویر قهرمان کلاس، در صورت وجود، نمایش داده می شود. اگر تصویر قهرمان کلاس نیز وجود نداشته باشد، چیزی نمایش داده نخواهد شد.

grouping Info

object ( GroupingInfo )

اطلاعاتی که نحوه گروه بندی پاس ها را کنترل می کند.

pass Constraints

object ( PassConstraints )

تصویب محدودیت برای شی. شامل محدود کردن NFC و رفتارهای اسکرین شات است.

save Restrictions

object ( SaveRestrictions )

محدودیت‌هایی در مورد شیئی که باید قبل از اینکه کاربر تلاش کند پاس را ذخیره کند تأیید شود. توجه داشته باشید که این محدودیت فقط در زمان صرفه جویی اعمال خواهد شد. اگر پس از ذخیره گذرنامه توسط کاربر، محدودیت‌ها تغییر کردند، محدودیت‌های جدید برای مجوز ذخیره‌شده قبلی اعمال نمی‌شوند.

linked Object Ids[]

string

linkedObjectIds لیستی از اشیاء دیگر مانند بلیط رویداد، وفاداری، پیشنهاد، عمومی، کارت هدیه، حمل و نقل و کارت پرواز هستند که باید به طور خودکار به این شی پرواز متصل شوند. اگر کاربری این کارت پرواز را ذخیره کرده باشد، این linkedObjectIds به طور خودکار به کیف پول کاربر منتقل می‌شوند (مگر اینکه تنظیمات دریافت چنین مجوزهای پیوندی را خاموش کرده باشند).

مطمئن شوید که اشیاء موجود در linkedObjectIds قبلاً درج شده اند - در غیر این صورت، تماس ها ناموفق خواهند بود. پس از پیوند، اشیاء پیوند شده را نمی توان لغو پیوند کرد. شما نمی توانید اشیاء متعلق به صادرکننده دیگری را پیوند دهید. محدودیتی برای تعداد اشیایی وجود دارد که می توان به یک شیء متصل کرد. پس از رسیدن به حد مجاز، اشیاء پیوند شده جدید در تماس بی‌صدا نادیده گرفته می‌شوند.

شناسه‌های شیء باید از issuer ID قالب پیروی کنند. identifier جایی که اولی توسط Google صادر می شود و دومی توسط شما انتخاب می شود.

notify Preference

enum ( NotificationSettingsForUpdates )

اینکه آیا به‌روزرسانی‌های فیلد برای این شی باید اعلان‌ها را راه‌اندازی کند یا خیر. وقتی روی NOTIFY تنظیم شود، سعی می کنیم یک اعلان به روز رسانی فیلد را برای کاربران فعال کنیم. این اعلان‌ها تنها در صورتی برای کاربران ارسال می‌شوند که این قسمت بخشی از یک لیست مجاز باشد. اگر روی DO_NOT_NOTIFY یا NOTIFICATION_SETTINGS_UNSPECIFIED تنظیم شود، هیچ اعلانی فعال نخواهد شد. این تنظیم زودگذر است و باید با هر درخواست PATCH یا UPDATE تنظیم شود، در غیر این صورت اعلانی راه اندازی نمی شود.

value Added Module Data[]

object ( ValueAddedModuleData )

داده های ماژول ارزش افزوده اختیاری. حداکثر ده روی جسم.

اطلاعات شبانه روزی و نشستن

نمایندگی JSON 
{
  "kind": string,
  "boardingGroup": string,
  "seatNumber": string,
  "seatClass": string,
  "boardingPrivilegeImage": {
    object (Image)
  },
  "boardingPosition": string,
  "sequenceNumber": string,
  "boardingDoor": enum (BoardingDoor),
  "seatAssignment": {
    object (LocalizedString)
  }
}
فیلدها
kind
(deprecated)

string

مشخص می کند که این چه نوع منبعی است. مقدار: رشته ثابت "walletobjects#boardingAndSeatingInfo" .

boarding Group

string

ارزش گروه (یا منطقه) سوار شدن این مسافر باید با آن سوار شود.

به عنوان مثال: "B"

برچسب این مقدار توسط فیلد boardingPolicy در flightClass که توسط این شی ارجاع داده شده است، تعیین می شود.

seat Number

string

ارزش صندلی مسافر اگر شناسه خاصی وجود ندارد، به جای آن از seatAssignment استفاده کنید.

به عنوان مثال: "25A"

seat Class

string

ارزش کلاس صندلی.

به عنوان مثال: "Economy" یا "Economy Plus"

boarding Privilege Image

object ( Image )

یک تصویر کوچک در بالای بارکد سوار شدن به هواپیما نشان داده شده است. خطوط هوایی می توانند از آن برای برقراری ارتباط با هر گونه امتیاز ویژه سوار شدن استفاده کنند. در صورتی که لوگوی برنامه امنیتی نیز تنظیم شده باشد، ممکن است این تصویر در کنار لوگوی آن برنامه امنیتی ارائه شود.

boarding Position

string

ارزش موقعیت سوار شدن.

به عنوان مثال: "76"

sequence Number

string

شماره ترتیب روی کارت پرواز. این معمولاً با ترتیب ورود مسافران مطابقت دارد. شرکت هواپیمایی ممکن است از این شماره برای برچسب‌های سوار شدن دستی و چمدان استفاده کند.

به عنوان مثال: "49"

boarding Door

enum ( BoardingDoor )

این فیلد را فقط در صورتی تنظیم کنید که این پرواز از بیش از یک در یا پل عبور کند و بخواهید به صراحت مکان در را روی کارت پرواز چاپ کنید. بیشتر خطوط هوایی مسافران خود را با مراجعه به درها/پل های کنار seatClass به سمت در یا پل سمت راست هدایت می کنند. در این موارد boardingDoor نباید تنظیم شود.

seat Assignment

object ( LocalizedString )

تعیین تکلیف صندلی مسافر. برای استفاده زمانی که هیچ شناسه خاصی برای استفاده در seatNumber وجود ندارد.

به عنوان مثال: "تخصیص در دروازه"

درب شبانه روزی

Enums
BOARDING_DOOR_UNSPECIFIED
FRONT
front

نام مستعار Legacy برای FRONT . منسوخ شده است.

BACK
back

نام مستعار Legacy برای BACK . منسوخ شده است.

ReservationInfo

نمایندگی JSON 
{
  "kind": string,
  "confirmationCode": string,
  "eticketNumber": string,
  "frequentFlyerInfo": {
    object (FrequentFlyerInfo)
  }
}
فیلدها
kind
(deprecated)

string

مشخص می کند که این چه نوع منبعی است. مقدار: رشته ثابت "walletobjects#reservationInfo" .

confirmation Code

string

برای ورود به این پرواز به کد تأیید نیاز است.

این شماره ای است که مسافر برای جستجوی پرواز و چاپ کارت پرواز به کیوسکی در فرودگاه وارد می کند.

eticket Number

string

شماره بلیت الکترونیکی

frequent Flyer Info

object ( FrequentFlyerInfo )

اطلاعات عضویت در پروازهای مکرر

FrequentFlyerInfo

نمایندگی JSON 
{
  "kind": string,
  "frequentFlyerProgramName": {
    object (LocalizedString)
  },
  "frequentFlyerNumber": string
}
فیلدها
kind
(deprecated)

string

مشخص می کند که این چه نوع منبعی است. مقدار: رشته ثابت "walletobjects#frequentFlyerInfo" .

frequent Flyer Program Name

object ( LocalizedString )

نام برنامه پروازهای مکرر به عنوان مثال: "Lufthansa Miles & More"

frequent Flyer Number

string

شماره پرواز مکرر

برای هر شی تودرتو از نوع walletobjects#frequentFlyerInfo مورد نیاز است.

روش ها

addmessage

 یک پیام به شی پروازی که توسط شناسه شی داده شده ارجاع داده شده است اضافه می کند.

get

 شی پرواز را با شناسه شی داده شده برمی گرداند.

insert

 یک شی پرواز را با شناسه و ویژگی های داده شده درج می کند.

list

 فهرستی از تمام اشیاء پرواز را برای شناسه صادرکننده معین برمی گرداند.

patch

 شی پروازی که توسط شناسه شی داده شده ارجاع داده شده است را به روز می کند.

update

 شی پروازی که توسط شناسه شی داده شده ارجاع داده شده است را به روز می کند.