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)
}
زمینه های
kind
(deprecated)

string

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

localScheduledDepartureDateTime

string

ضروری. تاریخ و زمان برنامه ریزی شده ای که انتظار می رود هواپیما از دروازه خارج شود (نه باند)

توجه: این فیلد نباید خیلی نزدیک به زمان حرکت تغییر کند. برای به‌روزرسانی زمان‌های حرکت (تأخیر و غیره)، لطفاً localEstimatedOrActualDepartureDateTime را تنظیم کنید.

این تاریخ/زمان با فرمت توسعه یافته ISO 8601 بدون افست است. زمان ممکن است با دقت میلی ثانیه مشخص شود.

به عنوان مثال: 2027-03-05T06:30:00

این باید تاریخ/زمان محلی فرودگاه باشد (نه زمان UTC).

اگر افست UTC ارائه شود، Google این درخواست را رد خواهد کرد. مناطق زمانی توسط گوگل بر اساس فرودگاه مبدا محاسبه می شود.

localEstimatedOrActualDepartureDateTime

string

زمان تخمینی که هواپیما قصد دارد از دروازه خارج شود یا زمانی که هواپیما قبلاً از دروازه خارج شده است. توجه: این زمان باند نیست.

اگر حداقل یکی از موارد زیر درست باشد، این فیلد باید تنظیم شود:

  • با زمان برنامه ریزی شده متفاوت است. گوگل از آن برای محاسبه تاخیر استفاده می کند.
  • هواپیما قبلاً از دروازه خارج شده است. گوگل از آن استفاده می کند تا به کاربر اطلاع دهد که پرواز واقعاً چه زمانی حرکت کرده است.

این تاریخ/زمان با فرمت توسعه یافته ISO 8601 بدون افست است. زمان ممکن است با دقت میلی ثانیه مشخص شود.

به عنوان مثال: 2027-03-05T06:30:00

این باید تاریخ/زمان محلی فرودگاه باشد (نه زمان UTC).

اگر افست UTC ارائه شود، Google این درخواست را رد خواهد کرد. مناطق زمانی توسط گوگل بر اساس فرودگاه مبدا محاسبه می شود.

اگر این تنظیم نشده باشد، Google آن را بر اساس داده‌های منابع دیگر تنظیم می‌کند.

localBoardingDateTime

string

زمان پرواز همانطور که در کارت پرواز چاپ می شود.

این تاریخ/زمان با فرمت توسعه یافته ISO 8601 بدون افست است. زمان ممکن است با دقت میلی ثانیه مشخص شود.

به عنوان مثال: 2027-03-05T06:30:00

این باید تاریخ/زمان محلی فرودگاه باشد (نه زمان UTC).

اگر افست UTC ارائه شود، Google این درخواست را رد خواهد کرد. مناطق زمانی توسط گوگل بر اساس فرودگاه مبدا محاسبه می شود.

اگر این تنظیم نشده باشد، Google آن را بر اساس داده‌های منابع دیگر تنظیم می‌کند.

localScheduledArrivalDateTime

string

زمان برنامه ریزی شده هواپیما برای رسیدن به دروازه مقصد (نه باند).

توجه: این قسمت نباید خیلی نزدیک به زمان پرواز تغییر کند. برای به‌روزرسانی زمان‌های حرکت (تأخیر و غیره)، لطفاً localEstimatedOrActualArrivalDateTime را تنظیم کنید.

این تاریخ/زمان با فرمت توسعه یافته ISO 8601 بدون افست است. زمان ممکن است با دقت میلی ثانیه مشخص شود.

به عنوان مثال: 2027-03-05T06:30:00

این باید تاریخ/زمان محلی فرودگاه باشد (نه زمان UTC).

اگر افست UTC ارائه شود، Google این درخواست را رد خواهد کرد. مناطق زمانی توسط گوگل بر اساس فرودگاه ورود محاسبه می شود.

اگر این تنظیم نشده باشد، Google آن را بر اساس داده‌های منابع دیگر تنظیم می‌کند.

localEstimatedOrActualArrivalDateTime

string

زمان تخمینی هواپیما برای رسیدن به دروازه مقصد (نه باند) یا زمان واقعی رسیدن به دروازه.

اگر حداقل یکی از موارد زیر درست باشد، این فیلد باید تنظیم شود:

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

این تاریخ/زمان با فرمت توسعه یافته ISO 8601 بدون افست است. زمان ممکن است با دقت میلی ثانیه مشخص شود.

به عنوان مثال: 2027-03-05T06:30:00

این باید تاریخ/زمان محلی فرودگاه باشد (نه زمان UTC).

اگر افست UTC ارائه شود، Google این درخواست را رد خواهد کرد. مناطق زمانی توسط گوگل بر اساس فرودگاه ورود محاسبه می شود.

اگر این تنظیم نشده باشد، 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).

اگر افست 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[]

object ( LatLongPoint )

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

reviewStatus

enum ( ReviewStatus )

ضروری. وضعیت کلاس. با استفاده از درج، وصله یا به‌روزرسانی فراخوان‌های API، می‌توان این فیلد را روی draft یا underReview تنظیم کرد. هنگامی که وضعیت بررسی از 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 نیز باید به درستی تنظیم شوند تا پاس از Smart Tap پشتیبانی کند.

countryCode

string

کد کشوری که برای نمایش کشور کارت (زمانی که کاربر در آن کشور نیست) و همچنین برای نمایش محتوای بومی سازی شده در زمانی که محتوا در محلی کاربر در دسترس نیست، استفاده می شود.

heroImage

object ( Image )

تصویر بنر اختیاری در جلوی کارت نمایش داده می شود. اگر هیچ کدام وجود نداشته باشد، چیزی نمایش داده نمی شود. تصویر با عرض 100% نمایش داده می شود.

wordMark
(deprecated)

object ( Image )

منسوخ.

enableSmartTap

boolean

تشخیص می دهد که آیا این کلاس از Smart Tap پشتیبانی می کند یا خیر. فیلدهای redemptionIssuers و سطح شیء smartTapRedemptionLevel نیز باید به درستی تنظیم شوند تا مجوز از Smart Tap پشتیبانی کند.

hexBackgroundColor

string

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

localizedIssuerName

object ( LocalizedString )

رشته های ترجمه شده برای صادرکنندهName. حداکثر طول توصیه شده 20 کاراکتر است تا اطمینان حاصل شود که رشته کامل در صفحه های کوچکتر نمایش داده می شود.

multipleDevicesAndHoldersAllowedStatus

enum ( MultipleDevicesAndHoldersAllowedStatus )

مشخص می کند که آیا چندین کاربر و دستگاه یک شیء مشابه را با ارجاع به این کلاس ذخیره می کنند یا خیر.

callbackOptions

object ( CallbackOptions )

گزینه‌های Callback برای فراخوانی مجدد صادرکننده برای هر ذخیره/حذف یک شی برای این کلاس توسط کاربر نهایی استفاده می‌شود. همه اشیاء این کلاس واجد شرایط بازگشت به تماس هستند.

securityAnimation

object ( SecurityAnimation )

اطلاعات اختیاری در مورد انیمیشن امنیتی. اگر این تنظیم باشد، یک انیمیشن امنیتی در جزئیات پاس نمایش داده می شود.

viewUnlockRequirement

enum ( ViewUnlockRequirement )

مشاهده گزینه های مورد نیاز باز کردن قفل برای کارت پرواز.

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

شماره پرواز بدون کد شرکت یاتا. این فیلد فقط باید دارای اعداد باشد. این ویژگی مورد نیاز flightHeader است.

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

operatingCarrier

object ( FlightCarrier )

اطلاعات در مورد شرکت هواپیمایی فعال

operatingFlightNumber

string

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

به عنوان مثال: "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

کد سه کاراکتری شرکت هواپیمایی ایکائو شرکت بازاریابی (برخلاف شرکت حامل). دقیقاً یکی از این یا carrierIataCode باید برای carrier و operatingCarrier ارائه شود.

به عنوان مثال: "EZY" برای ایزی جت

airlineName

object ( LocalizedString )

نام محلی شرکت هواپیمایی که توسط carrierIataCode مشخص شده است. در صورت تنظیم نشدن، issuerName یا localizedIssuerName از FlightClass برای اهداف نمایش استفاده خواهد شد.

به عنوان مثال: "Swiss Air" برای "LX"

فرودگاه اطلاعات

نمایندگی JSON
{
  "kind": string,
  "airportIataCode": string,
  "terminal": string,
  "gate": string,
  "airportNameOverride": {
    object (LocalizedString)
  }
}
زمینه های
kind
(deprecated)

string

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

airportIataCode

string

کد سه کاراکتری یاتا فرودگاه. این یک فیلد ضروری برای origin و destination است.

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

terminal

string

نام ترمینال به عنوان مثال: "INTL" یا "I"

gate

string

نامی از دروازه به عنوان مثال: "B59" یا "59"

airportNameOverride

object ( LocalizedString )

فیلد اختیاری که نام شهر فرودگاه تعریف شده توسط یاتا را لغو می کند. به‌طور پیش‌فرض، Google airportIataCode ارائه‌شده را می‌گیرد و آن را به نام شهر رسمی فرودگاه که توسط یاتا تعریف شده است، نقشه‌برداری می‌کند.

نام‌های رسمی شهر فرودگاه یاتا را می‌توانید در وب‌سایت نام‌های شهر فرودگاه یاتا بیابید. به عنوان مثال، برای کد یاتا فرودگاه "LTN"، وب سایت یاتا به ما می گوید که شهر فرودگاه مربوطه "لندن" است.

اگر این فیلد پر نباشد، گوگل "London" را نمایش می دهد.

با این حال، پر کردن این فیلد با یک نام سفارشی (به عنوان مثال: "London Luton") آن را لغو می کند.

وضعیت پرواز

Enums
FLIGHT_STATUS_UNSPECIFIED
SCHEDULED پرواز به موقع، زود یا با تاخیر انجام می شود.
scheduled

نام مستعار قدیمی برای SCHEDULED . منسوخ.

ACTIVE پرواز در حال انجام است (تاکسی، برخاستن، فرود، هوابرد).
active

نام مستعار قدیمی برای ACTIVE . منسوخ.

LANDED پرواز در مقصد اصلی فرود آمد.
landed

نام مستعار میراث برای LANDED . منسوخ.

CANCELLED پرواز کنسل شده است.
cancelled

نام مستعار قدیمی برای CANCELLED . منسوخ.

REDIRECTED پرواز هوابرد است اما به سمت فرودگاهی متفاوت از مقصد اصلی حرکت می کند.
redirected

نام مستعار قدیمی برای REDIRECTED . منسوخ.

DIVERTED پرواز قبلاً در فرودگاهی متفاوت از مقصد اصلی فرود آمده است.
diverted

نام مستعار قدیمی برای DIVERTED . منسوخ.

سیاست شبانه روزی و نشستن

نمایندگی JSON
{
  "kind": string,
  "boardingPolicy": enum (BoardingPolicy),
  "seatClassPolicy": enum (SeatClassPolicy)
}
زمینه های
kind
(deprecated)

string

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

boardingPolicy

enum ( BoardingPolicy )

سیاستی را که شرکت هواپیمایی برای سوار شدن استفاده می کند نشان می دهد. اگر تنظیم نشود، Google پیش‌فرض zoneBased را انتخاب می‌کند.

seatClassPolicy

enum ( SeatClassPolicy )

خط مشی صندلی که نحوه نمایش کلاس صندلی را دیکته می کند. اگر تنظیم نشود، Google پیش‌فرض cabinBased را تنظیم می‌کند.

سیاست شبانه روزی

Enums
BOARDING_POLICY_UNSPECIFIED
ZONE_BASED
zoneBased

نام مستعار قدیمی برای ZONE_BASED . منسوخ.

GROUP_BASED
groupBased

نام مستعار قدیمی برای GROUP_BASED . منسوخ.

BOARDING_POLICY_OTHER
boardingPolicyOther

نام مستعار قدیمی برای BOARDING_POLICY_OTHER . منسوخ.

SeatClassPolicy

Enums
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

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