REST Resource: flightclass

Resource: FlightClass

Representasi 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)
    }
  ]
}
Kolom
kind
(deprecated)

string

Mengidentifikasi jenis resource ini. Nilai: string tetap "walletobjects#flightClass".

localScheduledDepartureDateTime

string

Wajib. Tanggal dan waktu terjadwal saat pesawat diperkirakan akan berangkat dari gerbang (bukan landasan pacu)

Catatan: Kolom ini tidak boleh berubah terlalu dekat dengan waktu keberangkatan. Untuk pembaruan waktu keberangkatan (keterlambatan, dll.), harap tetapkan localEstimatedOrActualDepartureDateTime.

Ini adalah tanggal/waktu format diperluas ISO 8601 tanpa offset. Waktu dapat ditentukan hingga presisi milidetik.

misalnya: 2027-03-05T06:30:00

Tanggal/waktu ini harus berupa tanggal/waktu lokal di bandara (bukan waktu UTC).

Google akan menolak permintaan jika offset UTC diberikan. Zona waktu akan dihitung oleh Google berdasarkan bandara keberangkatan.

localEstimatedOrActualDepartureDateTime

string

Perkiraan waktu pesawat akan ditarik dari gerbang atau waktu sebenarnya pesawat sudah ditarik dari gerbang. Catatan: Ini bukan waktu landasan pacu.

Kolom ini harus ditetapkan jika setidaknya salah satu hal berikut berlaku:

  • Jadwal ini berbeda dengan waktu yang dijadwalkan. Google akan menggunakannya untuk menghitung jeda.
  • Pesawat sudah ditarik dari gerbang. Google akan menggunakannya untuk memberi tahu pengguna kapan pesawat benar-benar berangkat.

Ini adalah tanggal/waktu format diperluas ISO 8601 tanpa offset. Waktu dapat ditentukan hingga presisi milidetik.

misalnya: 2027-03-05T06:30:00

Tanggal/waktu ini harus berupa tanggal/waktu lokal di bandara (bukan waktu UTC).

Google akan menolak permintaan jika offset UTC diberikan. Zona waktu akan dihitung oleh Google berdasarkan bandara keberangkatan.

localBoardingDateTime

string

Waktu keberangkatan seperti yang akan dicetak di boarding pass.

Ini adalah tanggal/waktu format diperluas ISO 8601 tanpa offset. Waktu dapat ditentukan hingga presisi milidetik.

misalnya: 2027-03-05T06:30:00

Tanggal/waktu ini harus berupa tanggal/waktu lokal di bandara (bukan waktu UTC).

Google akan menolak permintaan jika offset UTC diberikan. Zona waktu akan dihitung oleh Google berdasarkan bandara keberangkatan.

localScheduledArrivalDateTime

string

Waktu terjadwal yang direncanakan pesawat untuk mencapai gerbang tujuan (bukan landasan pacu).

Catatan: Kolom ini tidak boleh berubah terlalu dekat dengan waktu penerbangan. Untuk pembaruan waktu keberangkatan (keterlambatan, dll.), harap tetapkan localEstimatedOrActualArrivalDateTime.

Ini adalah tanggal/waktu format diperluas ISO 8601 tanpa offset. Waktu dapat ditentukan hingga presisi milidetik.

misalnya: 2027-03-05T06:30:00

Tanggal/waktu ini harus berupa tanggal/waktu lokal di bandara (bukan waktu UTC).

Google akan menolak permintaan jika offset UTC diberikan. Zona waktu akan dihitung oleh Google berdasarkan bandara tujuan.

localEstimatedOrActualArrivalDateTime

string

Perkiraan waktu pesawat berencana mencapai gerbang tujuan (bukan landasan pacu) atau waktu sebenarnya pesawat mencapai gerbang.

Kolom ini harus ditetapkan jika setidaknya salah satu hal berikut berlaku:

  • Waktu ini berbeda dengan waktu yang dijadwalkan. Google akan menggunakannya untuk menghitung jeda.
  • Pesawat sudah tiba di gerbang. Google akan menggunakannya untuk memberi tahu pengguna bahwa penerbangan telah tiba di gerbang.

Ini adalah tanggal/waktu format diperluas ISO 8601 tanpa offset. Waktu dapat ditentukan hingga presisi milidetik.

misalnya: 2027-03-05T06:30:00

Tanggal/waktu ini harus berupa tanggal/waktu lokal di bandara (bukan waktu UTC).

Google akan menolak permintaan jika offset UTC diberikan. Zona waktu akan dihitung oleh Google berdasarkan bandara tujuan.

flightHeader

object (FlightHeader)

Wajib. Informasi tentang maskapai dan nomor penerbangan.

origin

object (AirportInfo)

Wajib. Bandara asal.

destination

object (AirportInfo)

Wajib. Bandara tujuan.

flightStatus

enum (FlightStatus)

Status penerbangan ini.

Jika tidak ditetapkan, Google akan menghitung status berdasarkan data dari sumber lain, seperti FlightStats, dll.

Catatan: Status yang dihitung Google tidak akan ditampilkan dalam respons API.

boardingAndSeatingPolicy

object (BoardingAndSeatingPolicy)

Kebijakan untuk naik dan duduk. Hal ini akan menentukan label mana yang akan ditampilkan kepada pengguna.

localGateClosingDateTime

string

Waktu penutupan gerbang seperti yang akan dicetak di boarding pass. Jangan tetapkan kolom ini jika Anda tidak ingin mencetaknya di boarding pass.

Ini adalah tanggal/waktu format diperluas ISO 8601 tanpa offset. Waktu dapat ditentukan hingga presisi milidetik.

misalnya: 2027-03-05T06:30:00

Tanggal/waktu ini harus berupa tanggal/waktu lokal di bandara (bukan waktu UTC).

Google akan menolak permintaan jika offset UTC diberikan. Zona waktu akan dihitung oleh Google berdasarkan bandara keberangkatan.

classTemplateInfo

object (ClassTemplateInfo)

Informasi template tentang cara kelas ditampilkan. Jika tidak ditetapkan, Google akan kembali ke kumpulan kolom default untuk ditampilkan.

languageOverride

string

Jika kolom ini ada, boarding pass yang ditayangkan ke perangkat pengguna akan selalu dalam bahasa ini. Merepresentasikan tag bahasa BCP 47. Contoh nilainya adalah "en-US", "en-GB", "de", atau "de-AT".

id

string

Wajib. ID unik untuk class. ID ini harus unik di semua class dari penerbit. Nilai ini harus mengikuti format issuer ID.identifier dengan yang pertama diterbitkan oleh Google dan yang kedua dipilih oleh Anda. ID unik Anda hanya boleh berisi karakter alfanumerik, '.', '_', atau '-'.

version
(deprecated)

string (int64 format)

Tidak digunakan lagi

issuerName

string

Wajib. Nama penerbit. Panjang maksimum yang direkomendasikan adalah 20 karakter untuk memastikan string lengkap ditampilkan di layar yang lebih kecil.

messages[]

object (Message)

Array pesan yang ditampilkan di aplikasi. Semua pengguna objek ini akan menerima pesan yang terkait dengannya. Jumlah maksimum kolom ini adalah 10.

allowMultipleUsersPerObject
(deprecated)

boolean

Tidak digunakan lagi. Sebagai gantinya, gunakan multipleDevicesAndHoldersAllowedStatus.

homepageUri

object (Uri)

URI halaman beranda aplikasi Anda. Mengisi URI di kolom ini akan menghasilkan perilaku yang sama persis dengan mengisi URI di linksModuleData (saat objek dirender, link ke halaman beranda ditampilkan di bagian yang biasanya dianggap sebagai bagian linksModuleData dari objek).

locations[]
(deprecated)

object (LatLongPoint)

Catatan: Kolom ini saat ini tidak didukung untuk memicu notifikasi geografis.

reviewStatus

enum (ReviewStatus)

Wajib. Status class. Kolom ini dapat ditetapkan ke draft atau underReview menggunakan panggilan API penyisipan, patch, atau update. Setelah status peninjauan diubah dari draft, status tersebut tidak dapat diubah kembali ke draft.

Anda harus mempertahankan kolom ini ke draft saat class sedang dalam pengembangan. Class draft tidak dapat digunakan untuk membuat objek apa pun.

Anda harus menetapkan kolom ini ke underReview jika yakin class sudah siap digunakan. Platform akan otomatis menetapkan kolom ini ke approved dan dapat langsung digunakan untuk membuat atau memigrasikan objek.

Saat mengupdate class yang sudah approved, Anda harus terus menetapkan kolom ini ke underReview.

review

object (Review)

Komentar ulasan yang ditetapkan oleh platform saat kelas ditandai approved atau rejected.

infoModuleData
(deprecated)

object (InfoModuleData)

Tidak digunakan lagi. Sebagai gantinya, gunakan textModulesData.

imageModulesData[]

object (ImageModuleData)

Data modul gambar. Jumlah maksimum kolom ini yang ditampilkan adalah 1 dari tingkat objek dan 1 untuk tingkat objek class.

textModulesData[]

object (TextModuleData)

Data modul teks. Jika data modul teks juga ditentukan di class, keduanya akan ditampilkan. Jumlah maksimum kolom ini yang ditampilkan adalah 10 dari objek dan 10 dari class.

redemptionIssuers[]

string (int64 format)

Mengidentifikasi penerbit penukaran mana yang dapat menukarkan kartu melalui Smart Tap. Penerbit penukaran diidentifikasi berdasarkan ID penerbitnya. Penerbit penukaran harus memiliki setidaknya satu kunci Ketuk Smart yang dikonfigurasi.

Kolom enableSmartTap dan smartTapRedemptionLevel tingkat objek juga harus disiapkan dengan benar agar kartu dapat mendukung Smart Tap.

countryCode

string

Kode negara yang digunakan untuk menampilkan negara kartu (saat pengguna tidak berada di negara tersebut), serta untuk menampilkan konten yang dilokalkan jika konten tidak tersedia dalam lokal pengguna.

heroImage

object (Image)

Gambar banner opsional yang ditampilkan di bagian depan kartu. Jika tidak ada, tidak ada yang akan ditampilkan. Gambar akan ditampilkan dengan lebar 100%.

wordMark
(deprecated)

object (Image)

Tidak digunakan lagi.

enableSmartTap

boolean

Mengidentifikasi apakah class ini mendukung Smart Tap. Kolom redemptionIssuers dan smartTapRedemptionLevel tingkat objek juga harus disiapkan dengan benar agar kartu dapat mendukung Smart Tap.

hexBackgroundColor

string

Warna latar belakang untuk kartu. Jika tidak ditetapkan, warna dominan gambar hero akan digunakan, dan jika tidak ada gambar hero yang ditetapkan, warna dominan logo akan digunakan. Formatnya adalah #rrggbb dengan rrggbb adalah triplet RGB heksadesimal, seperti #ffcc00. Anda juga dapat menggunakan versi singkat triplet RGB yaitu #rgb, seperti #fc0.

localizedIssuerName

object (LocalizedString)

String terjemahan untuk issuerName. Panjang maksimum yang direkomendasikan adalah 20 karakter untuk memastikan string lengkap ditampilkan di layar yang lebih kecil.

multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

Mengidentifikasi apakah beberapa pengguna dan perangkat akan menyimpan objek yang sama yang mereferensikan class ini.

callbackOptions

object (CallbackOptions)

Opsi callback yang akan digunakan untuk memanggil kembali penerbit untuk setiap penyimpanan/penghapusan objek untuk class ini oleh pengguna akhir. Semua objek class ini memenuhi syarat untuk callback.

securityAnimation

object (SecurityAnimation)

Informasi opsional tentang animasi keamanan. Jika kebijakan ini disetel, animasi keamanan akan dirender pada detail kartu.

viewUnlockRequirement

enum (ViewUnlockRequirement)

Lihat opsi Persyaratan Buka Kunci untuk boarding pass.

notifyPreference

enum (NotificationSettingsForUpdates)

Apakah pembaruan kolom pada class ini akan memicu notifikasi atau tidak. Jika ditetapkan ke NOTIFY, kami akan mencoba memicu notifikasi pembaruan kolom kepada pengguna. Notifikasi ini hanya akan dikirim kepada pengguna jika kolom tersebut merupakan bagian dari daftar yang diizinkan. Jika tidak ditentukan, tidak ada notifikasi yang akan dipicu. Setelan ini bersifat sementara dan harus disetel dengan setiap permintaan PATCH atau UPDATE. Jika tidak, notifikasi tidak akan dipicu.

valueAddedModuleData[]

object (ValueAddedModuleData)

Data modul nilai tambah opsional. Maksimum sepuluh di kelas. Untuk kartu, hanya sepuluh yang akan ditampilkan, dengan memprioritaskan kartu dari objek.

FlightHeader

Representasi JSON
{
  "kind": string,
  "carrier": {
    object (FlightCarrier)
  },
  "flightNumber": string,
  "operatingCarrier": {
    object (FlightCarrier)
  },
  "operatingFlightNumber": string,
  "flightNumberDisplayOverride": string
}
Kolom
kind
(deprecated)

string

Mengidentifikasi jenis resource ini. Nilai: string tetap "walletobjects#flightHeader".

carrier

object (FlightCarrier)

Informasi tentang maskapai penerbangan. Ini adalah properti wajib dari flightHeader.

flightNumber

string

Nomor penerbangan tanpa kode maskapai IATA. Kolom ini hanya boleh berisi angka. Ini adalah properti wajib dari flightHeader.

misalnya: "123"

operatingCarrier

object (FlightCarrier)

Informasi tentang maskapai penerbangan yang beroperasi.

operatingFlightNumber

string

Nomor penerbangan yang digunakan oleh maskapai operator tanpa kode maskapai IATA. Kolom ini hanya boleh berisi angka.

misalnya: "234"

flightNumberDisplayOverride

string

Ganti nilai yang akan digunakan untuk nomor penerbangan. Nilai default yang digunakan untuk tujuan tampilan adalah operator + penerbanganNumber. Jika nilai yang berbeda perlu ditampilkan kepada penumpang, gunakan kolom ini untuk mengganti perilaku default.

misalnya: "XX1234 / YY576"

FlightCarrier

Representasi JSON
{
  "kind": string,
  "carrierIataCode": string,
  "carrierIcaoCode": string,
  "airlineName": {
    object (LocalizedString)
  },
  "airlineLogo": {
    object (Image)
  },
  "airlineAllianceLogo": {
    object (Image)
  },
  "wideAirlineLogo": {
    object (Image)
  }
}
Kolom
kind
(deprecated)

string

Mengidentifikasi jenis resource ini. Nilai: string tetap "walletobjects#flightCarrier".

carrierIataCode

string

Kode maskapai penerbangan IATA dua karakter dari maskapai pemasaran (bukan maskapai operator). Persis satu dari ini atau carrierIcaoCode harus diberikan untuk carrier dan operatingCarrier.

misalnya: "LX" untuk Swiss Air

carrierIcaoCode

string

Kode maskapai penerbangan ICAO tiga karakter dari maskapai pemasaran (bukan maskapai operator). Tepat satu dari ini atau carrierIataCode harus diberikan untuk carrier dan operatingCarrier.

misalnya: "EZY" untuk Easy Jet

airlineName

object (LocalizedString)

Nama maskapai penerbangan yang dilokalkan dan ditentukan oleh carrierIataCode. Jika tidak ditetapkan, issuerName atau localizedIssuerName dari FlightClass akan digunakan untuk tujuan tampilan.

misalnya: "Swiss Air" untuk "LX"

AirportInfo

Representasi JSON
{
  "kind": string,
  "airportIataCode": string,
  "terminal": string,
  "gate": string,
  "airportNameOverride": {
    object (LocalizedString)
  }
}
Kolom
kind
(deprecated)

string

Mengidentifikasi jenis resource ini. Nilai: string tetap "walletobjects#airportInfo".

airportIataCode

string

Kode bandara IATA tiga karakter. Kolom ini wajib diisi untuk origin dan destination.

Misalnya: "SFO"

terminal

string

Nama terminal. Misalnya: "INTL" atau "I"

gate

string

Nama gerbang. Misalnya: "B59" atau "59"

airportNameOverride

object (LocalizedString)

Kolom opsional yang mengganti nama kota bandara yang ditentukan oleh IATA. Secara default, Google mengambil airportIataCode yang disediakan dan memetakan ke nama kota bandara resmi yang ditentukan oleh IATA.

Nama kota bandara IATA resmi dapat ditemukan di situs Nama kota bandara IATA. Misalnya, untuk kode IATA bandara "LTN", situs web IATA memberitahukan bahwa kota bandara yang sesuai adalah "London".

Jika kolom ini tidak diisi, Google akan menampilkan "London".

Namun, mengisi kolom ini dengan nama kustom (misalnya: "London Luton") akan menggantinya.

FlightStatus

Enum
FLIGHT_STATUS_UNSPECIFIED
SCHEDULED Penerbangan tepat waktu, lebih awal, atau tertunda.
scheduled

Alias lama untuk SCHEDULED. Tidak digunakan lagi.

ACTIVE Penerbangan sedang berlangsung (maju mundur, lepas landas, mendarat, di udara).
active

Alias lama untuk ACTIVE. Tidak digunakan lagi.

LANDED Pesawat mendarat di tujuan awal.
landed

Alias lama untuk LANDED. Tidak digunakan lagi.

CANCELLED Penerbangan dibatalkan.
cancelled

Alias lama untuk CANCELLED. Tidak digunakan lagi.

REDIRECTED Penerbangan sudah mengudara, tetapi menuju ke bandara yang berbeda dengan tujuan awal.
redirected

Alias lama untuk REDIRECTED. Tidak digunakan lagi.

DIVERTED Penerbangan telah mendarat di bandara yang berbeda dengan tujuan awal.
diverted

Alias lama untuk DIVERTED. Tidak digunakan lagi.

BoardingAndSeatingPolicy

Representasi JSON
{
  "kind": string,
  "boardingPolicy": enum (BoardingPolicy),
  "seatClassPolicy": enum (SeatClassPolicy)
}
Kolom
kind
(deprecated)

string

Mengidentifikasi jenis resource ini. Nilai: string tetap "walletobjects#boardingAndSeatingPolicy".

boardingPolicy

enum (BoardingPolicy)

Menunjukkan kebijakan yang digunakan maskapai penerbangan untuk naik pesawat. Jika tidak ditetapkan, Google akan menetapkan setelan default ke zoneBased.

seatClassPolicy

enum (SeatClassPolicy)

Kebijakan tempat duduk yang menentukan cara kami menampilkan kelas kursi. Jika tidak ditetapkan, Google akan menetapkan setelan default ke cabinBased.

BoardingPolicy

Enum
BOARDING_POLICY_UNSPECIFIED
ZONE_BASED
zoneBased

Alias lama untuk ZONE_BASED. Tidak digunakan lagi.

GROUP_BASED
groupBased

Alias lama untuk GROUP_BASED. Tidak digunakan lagi.

BOARDING_POLICY_OTHER
boardingPolicyOther

Alias lama untuk BOARDING_POLICY_OTHER. Tidak digunakan lagi.

SeatClassPolicy

Enum
SEAT_CLASS_POLICY_UNSPECIFIED
CABIN_BASED
cabinBased

Alias lama untuk CABIN_BASED. Tidak digunakan lagi.

CLASS_BASED
classBased

Alias lama untuk CLASS_BASED. Tidak digunakan lagi.

TIER_BASED
tierBased

Alias lama untuk TIER_BASED. Tidak digunakan lagi.

SEAT_CLASS_POLICY_OTHER
seatClassPolicyOther

Alias lama untuk SEAT_CLASS_POLICY_OTHER. Tidak digunakan lagi.

Metode

addmessage

Menambahkan pesan ke class penerbangan yang dirujuk oleh ID class yang diberikan.

get

Menampilkan kelas penerbangan dengan ID kelas yang diberikan.

insert

Menyisipkan class penerbangan dengan ID dan properti yang diberikan.

list

Menampilkan daftar semua kelas penerbangan untuk ID penerbit tertentu.

patch

Memperbarui kelas penerbangan yang dirujuk oleh ID kelas yang diberikan.

update

Memperbarui class penerbangan yang dirujuk oleh ID class yang diberikan.