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),
  "appLinkData": {
    object (AppLinkData)
  }
}
Kolom
kind
(deprecated)

string

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

localScheduledDepartureDateTime

string

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

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

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

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

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 berencana untuk mendarat dari gerbang atau waktu sebenarnya pesawat sudah ditarik dari gerbang. Catatan: Ini bukan waktu landasan.

Kolom ini harus ditetapkan jika setidaknya salah satu kondisi di bawah ini terpenuhi:

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

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

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

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 naik turun seperti yang akan dicetak di boarding pass.

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

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

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 pesawat berencana untuk mencapai gerbang tujuan (bukan landasan pacu).

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

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

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

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 kedatangan.

localEstimatedOrActualArrivalDateTime

string

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

Kolom ini harus ditetapkan jika setidaknya salah satu kondisi di bawah ini terpenuhi:

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

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

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

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 kedatangan.

flightHeader

object (FlightHeader)

Wajib. Informasi tentang maskapai penerbangan dan nomornya.

origin

object (AirportInfo)

Wajib. Bandara asal.

destination

object (AirportInfo)

Wajib. Bandara tujuan.

flightStatus

enum (FlightStatus)

Status penerbangan ini.

Jika tidak disetel, 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 terkait boarding dan tempat duduk. Hal ini akan menginformasikan label mana yang akan ditampilkan kepada pengguna.

localGateClosingDateTime

string

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

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

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

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 class harus ditampilkan. Jika tidak disetel, Google akan kembali ke kumpulan kolom default yang akan ditampilkan.

languageOverride

string

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

id

string

Wajib. ID unik untuk kelas. ID ini harus unik di semua kelas dari penerbit. Nilai ini harus mengikuti format issuer ID.identifier 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 disarankan 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. 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 menghasilkan perilaku yang sama persis seperti mengisi URI di linksModuleData (saat objek dirender, link ke halaman beranda akan ditampilkan di bagian yang biasanya dianggap sebagai bagian linksModuleData objek).

locations[]

object (LatLongPoint)

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

reviewStatus

enum (ReviewStatus)

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

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

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

Saat memperbarui class approved yang sudah ada, Anda harus tetap menyetel kolom ini ke underReview.

review

object (Review)

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

infoModuleData
(deprecated)

object (InfoModuleData)

Tidak digunakan lagi. Sebagai gantinya, gunakan textModulesData.

imageModulesData[]

object (ImageModuleData)

Data modul gambar. Jumlah maksimum kolom 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 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 Smart Tap yang dikonfigurasi.

Kolom enableSmartTap dan smartTapRedemptionLevel tingkat objek juga harus disiapkan dengan benar agar kartu 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 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 mendukung Smart Tap.

hexBackgroundColor

string

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

localizedIssuerName

object (LocalizedString)

String yang diterjemahkan untuk penerbitName. Panjang maksimum yang disarankan 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 dengan mereferensikan class ini.

callbackOptions

object (CallbackOptions)

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

securityAnimation

object (SecurityAnimation)

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

viewUnlockRequirement

enum (ViewUnlockRequirement)

Lihat opsi Persyaratan Buka Kunci untuk boarding pass.

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. Bidang 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 penerbangan tanpa kode maskapai IATA. Bidang 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 ekspedisi + 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 yang terdiri dari dua karakter dari maskapai penerbangan pemasaran (berlawanan dengan operator operasi). 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 penerbangan (bukan operator operasi). Persis 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 operatorIataCode. Jika tidak disetel, 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 memetakannya ke nama kota bandara resmi yang ditentukan oleh IATA.

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

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

Namun, mengisi kolom ini dengan nama khusus (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 (naik taksi, lepas landas, mendarat, di udara).
active

Alias lama untuk ACTIVE. Tidak digunakan lagi.

LANDED Penerbangan 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 udara tetapi menuju ke bandara yang berbeda dari tujuan awal.
redirected

Alias lama untuk REDIRECTED. Tidak digunakan lagi.

DIVERTED Penerbangan sudah mendarat di bandara yang berbeda dari 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 disetel, Google akan menetapkan zoneBased secara default.

seatClassPolicy

enum (SeatClassPolicy)

Kebijakan tempat duduk yang menentukan cara kami menampilkan kelas kursi. Jika tidak disetel, Google akan menetapkan cabinBased secara default.

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 kelas penerbangan yang dirujuk oleh ID kelas yang diberikan.

get

Menampilkan class penerbangan dengan ID kelas yang diberikan.

insert

Menyisipkan kelas 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 kelas penerbangan yang dirujuk oleh ID kelas yang diberikan.