REST Resource: flightclass

Referensi: 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)
}
Kolom
kind
(deprecated)

string

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

localScheduledDepartureDateTime

string

Wajib. Tanggal dan waktu yang dijadwalkan saat pesawat diharapkan meninggalkan gerbang (bukan landasan pacu)

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

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

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

Ini harus merupakan tanggal/waktu setempat di bandara (bukan waktu UTC).

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

localEstimatedOrActualDepartureDateTime

string

Perkiraan waktu yang direncanakan pesawat untuk menarik dari gerbang atau waktu sebenarnya yang dilakukan pesawat dari gerbang. Catatan: Ini bukan waktu landasan.

Kolom ini harus ditetapkan jika setidaknya salah satu kondisi di bawah 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 tersebut benar-benar berangkat.

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

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

Ini harus merupakan tanggal/waktu setempat di bandara (bukan waktu UTC).

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

Jika tidak disetel, Google akan menyetelnya berdasarkan data dari sumber lain.

localBoardingDateTime

string

Waktu boarding seperti yang akan dicetak di boarding pass.

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

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

Ini harus merupakan tanggal/waktu setempat di bandara (bukan waktu UTC).

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

Jika tidak disetel, Google akan menyetelnya berdasarkan data dari sumber lain.

localScheduledArrivalDateTime

string

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

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

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

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

Ini harus merupakan tanggal/waktu setempat di bandara (bukan waktu UTC).

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

Jika tidak disetel, Google akan menyetelnya berdasarkan data dari sumber lain.

localEstimatedOrActualArrivalDateTime

string

Perkiraan waktu rencana pesawat untuk mencapai gerbang tujuan (bukan landasan pacu) atau waktu sebenarnya saat pesawat mencapai gerbang.

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

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

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

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

Ini harus merupakan tanggal/waktu setempat di bandara (bukan waktu UTC).

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

Jika tidak disetel, Google akan menyetelnya berdasarkan data dari sumber lain.

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 disetel, Google akan menghitung status berdasarkan data dari sumber lain, seperti FlightStats, dll.

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

boardingAndSeatingPolicy

object (BoardingAndSeatingPolicy)

Kebijakan untuk naik turun dan tempat duduk. Ini akan menginformasikan label mana yang akan ditampilkan kepada pengguna.

localGateClosingDateTime

string

Waktu tutup 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 ISO 8601 yang diperpanjang tanpa offset. Waktu dapat ditentukan hingga presisi milidetik.

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

Ini harus merupakan tanggal/waktu setempat di bandara (bukan waktu UTC).

Google akan menolak permintaan tersebut 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 untuk ditampilkan.

languageOverride

string

Jika kolom ini ada, boarding pass yang ditayangkan ke perangkat pengguna akan selalu menggunakan bahasa ini. Mewakili tag bahasa BCP 47. Nilai contoh 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 file yang pertama diterbitkan oleh Google dan versi kedua dipilih oleh Anda. ID unik 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 terkaitnya. 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 dalam kolom ini menghasilkan perilaku yang sama persis dengan mengisi URI di linksModuleData (saat objek dirender, link ke halaman beranda ditampilkan dalam hal yang biasanya dianggap sebagai bagian linksModuleData dari objek).

locations[]

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 insert, patch, atau update. Setelah diubah dari draft, status peninjauan 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 Anda yakin bahwa class sudah siap digunakan. Platform akan otomatis menetapkan kolom ini ke approved dan kolom ini dapat segera digunakan untuk membuat atau memigrasikan objek.

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

review

object (Review)

Komentar ulasan yang ditetapkan oleh platform saat class ditandai sebagai 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 ditetapkan pada 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 mengonfigurasi setidaknya satu tombol Smart Tap.

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

countryCode

string

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

heroImage

object (Image)

Gambar banner opsional yang ditampilkan di bagian depan kartu. Jika tidak ada, tidak ada yang 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 level objek juga harus disiapkan dengan benar agar kartu dapat mendukung Smart Tap.

hexBackgroundColor

string

Warna latar belakang kartu. Jika tidak disetel, warna dominan gambar utama akan digunakan, dan jika gambar utama tidak 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 yang #rgb, seperti #fc0.

localizedIssuerName

object (LocalizedString)

Menerjemahkan string untuk publisherName. 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 merujuk class ini.

callbackOptions

object (CallbackOptions)

Opsi callback yang akan digunakan untuk memanggil penerbit kembali 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.

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

flightNumber

string

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

misalnya: "123"

operatingCarrier

object (FlightCarrier)

Informasi tentang maskapai penerbangan yang beroperasi.

operatingFlightNumber

string

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

misalnya: "234"

flightNumberDisplayOverride

string

Mengganti nilai yang akan digunakan untuk nomor penerbangan. Nilai default yang digunakan untuk tujuan tampilan adalah ekspedisi + flightsNumber. 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 operator pemasaran (bukan operator yang beroperasi). Tepat satu dari kolom ini atau carrierIcaoCode harus diberikan untuk carrier dan operatingCarrier.

misalnya: "LX" untuk Swiss Air

carrierIcaoCode

string

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

misalnya: "EZY" untuk Easy Jet

airlineName

object (LocalizedString)

Nama maskapai penerbangan yang dilokalkan yang ditentukan oleh ekspedisiIataCode. 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

Tiga karakter kode bandara IATA. Kolom ini wajib diisi untuk origin dan destination.

Misalnya: "SFO"

terminal

string

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

gate

string

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

airportNameOverride

object (LocalizedString)

Kolom opsional yang menggantikan nama kota bandara yang ditentukan oleh IATA. Secara default, Google menggunakan 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 memberitahu kita 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 menggantikannya.

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 melalui udara, tetapi menuju ke bandara yang berbeda dari tujuan aslinya.
redirected

Alias lama untuk REDIRECTED. Tidak digunakan lagi.

DIVERTED Penerbangan sudah mendarat di bandara yang berbeda dari tujuan aslinya.
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 boarding. Jika tidak disetel, Google akan menetapkan setelan default ke zoneBased.

seatClassPolicy

enum (SeatClassPolicy)

Kebijakan tempat duduk yang menentukan cara kita menampilkan class kursi. Jika tidak disetel, 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 class penerbangan dengan ID class yang diberikan.

insert

Menyisipkan class penerbangan dengan ID dan properti yang diberikan.

list

Menampilkan daftar semua class penerbangan untuk ID penerbit yang ditentukan.

patch

Mengupdate class penerbangan yang dirujuk oleh ID class yang diberikan.

update

Mengupdate class penerbangan yang dirujuk oleh ID class yang diberikan.