REST Resource: eventticketobject

Resource: EventTicketObject

Representasi JSON
{
  "kind": string,
  "classReference": {
    object (EventTicketClass)
  },
  "seatInfo": {
    object (EventSeat)
  },
  "reservationInfo": {
    object (EventReservationInfo)
  },
  "ticketHolderName": string,
  "ticketNumber": string,
  "ticketType": {
    object (LocalizedString)
  },
  "faceValue": {
    object (Money)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "linkedOfferIds": [
    string
  ],
  "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)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
Kolom
kind
(deprecated)

string

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

classReference

object (EventTicketClass)

Salinan kolom yang diwarisi dari class induk. Kolom ini diambil selama GET.

seatInfo

object (EventSeat)

Detail tempat duduk untuk tiket ini.

reservationInfo

object (EventReservationInfo)

Detail reservasi untuk tiket ini. Hal ini diharapkan akan dibagikan di antara semua tiket yang dibeli dalam pesanan yang sama.

ticketHolderName

string

Nama pemegang tiket, jika tiket diberikan kepada seseorang. Misalnya, "Budi Budiman" atau "Siti Siti".

ticketNumber

string

Nomor tiket. Ini dapat berupa ID unik di semua tiket dalam sistem penerbit, semua tiket untuk acara (misalnya, XYZ1234512345), atau semua tiket dalam urutan (1, 2, 3, dll.).

ticketType

object (LocalizedString)

Jenis tiket, seperti "Dewasa" atau "Anak", atau "VIP" atau "Standar".

faceValue

object (Money)

Nilai nominal tiket, yang cocok dengan yang akan dicetak pada versi fisik tiket.

groupingInfo

object (GroupingInfo)

Informasi yang mengontrol cara kartu dikelompokkan.

linkedOfferIds[]

string

Daftar objek penawaran yang ditautkan ke tiket acara ini. Objek penawaran harus sudah ada.

ID objek penawaran harus mengikuti format issuer ID.identifier dengan yang pertama diterbitkan oleh Google dan yang kedua dipilih oleh Anda.

hexBackgroundColor

string

Warna latar belakang 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 singkatan triplet RGB yang berupa #rgb, seperti #fc0.

id

string

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

classId

string

Wajib. Class yang terkait dengan objek ini. Class harus memiliki jenis yang sama dengan objek ini, harus sudah ada, dan harus disetujui.

ID class harus mengikuti format issuer ID.identifier dengan yang pertama diterbitkan oleh Google dan yang kedua dipilih oleh Anda.

version
(deprecated)

string (int64 format)

Tidak digunakan lagi

state

enum (State)

Wajib. Status objek. Kolom ini digunakan untuk menentukan cara objek ditampilkan di aplikasi. Misalnya, objek inactive dipindahkan ke bagian "Kartu yang sudah tidak berlaku".

barcode

object (Barcode)

Jenis dan nilai kode batang.

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.

validTimeInterval

object (TimeInterval)

Jangka waktu objek ini akan menjadi active dan objek dapat digunakan. Status objek akan diubah menjadi expired setelah jangka waktu ini berlalu.

locations[]
(deprecated)

object (LatLongPoint)

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

hasUsers

boolean

Menunjukkan apakah objek memiliki pengguna. Kolom ini ditetapkan oleh platform.

smartTapRedemptionValue

string

Nilai yang akan dikirim ke terminal bersertifikasi Smart Tap melalui NFC untuk objek ini. Kolom tingkat class enableSmartTap dan redemptionIssuers juga harus disiapkan dengan benar agar kartu dapat mendukung Smart Tap. Hanya karakter ASCII yang didukung.

hasLinkedDevice

boolean

Apakah objek ini saat ini ditautkan ke satu perangkat. Kolom ini ditetapkan oleh platform saat pengguna menyimpan objek, yang menautkannya ke perangkat mereka. Dimaksudkan untuk digunakan oleh partner tertentu. Hubungi dukungan untuk mendapatkan informasi tambahan.

disableExpirationNotification

boolean

Menunjukkan apakah notifikasi harus disembunyikan secara eksplisit. Jika kolom ini disetel ke benar (true), terlepas dari kolom messages, notifikasi habis masa berlaku kepada pengguna akan disembunyikan. Secara default, kolom ini ditetapkan ke false.

Saat ini, opsi ini hanya dapat ditetapkan untuk penawaran.

infoModuleData

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.

rotatingBarcode

object (RotatingBarcode)

Jenis dan nilai kode batang yang berputar.

heroImage

object (Image)

Gambar banner opsional yang ditampilkan di bagian depan kartu. Jika tidak ada, gambar hero class, jika ada, akan ditampilkan. Jika gambar hero kelas juga tidak ada, tidak ada yang akan ditampilkan.

passConstraints

object (PassConstraints)

Teruskan batasan untuk objek. Mencakup pembatasan perilaku NFC dan screenshot.

saveRestrictions

object (SaveRestrictions)

Batasan pada objek yang perlu diverifikasi sebelum pengguna mencoba menyimpan kartu. Perhatikan bahwa batasan ini hanya akan diterapkan selama waktu penyimpanan. Jika pembatasan berubah setelah pengguna menyimpan kartu, pembatasan baru tidak akan diterapkan ke kartu yang sudah disimpan.

linkedObjectIds[]

string

linkedObjectIds adalah daftar objek lain seperti tiket acara, loyalitas, penawaran, umum, kartu voucher, tiket multi-trip, dan boarding pass yang harus otomatis dilampirkan ke objek tiket acara ini. Jika pengguna telah menyimpan tiket acara ini, linkedObjectId ini akan otomatis dikirim ke dompet pengguna (kecuali jika mereka menonaktifkan setelan untuk menerima kartu tertaut tersebut).

Pastikan objek yang ada di linkedObjectIds sudah dimasukkan - jika tidak, panggilan akan gagal. Setelah ditautkan, objek tertaut tidak dapat dibatalkan tautannya. Anda tidak dapat menautkan objek milik penerbit lain. Ada batasan jumlah objek yang dapat ditautkan ke satu objek. Setelah batas tercapai, objek tertaut baru dalam panggilan akan diabaikan secara otomatis.

ID objek harus mengikuti format issuer ID.identifier dengan yang pertama diterbitkan oleh Google dan yang kedua dipilih oleh Anda.

notifyPreference

enum (NotificationSettingsForUpdates)

Apakah pembaruan kolom pada objek ini harus 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 kolomnya merupakan bagian dari daftar yang diizinkan. Jika disetel ke DO_NOT_NOTIFY atau NOTIFICATION_SETTINGS_UNSPECIFIED, tidak ada notifikasi yang akan dipicu. Setelan ini bersifat sementara dan perlu ditetapkan dengan setiap permintaan PATCH atau UPDATE. Jika tidak, notifikasi tidak akan dipicu.

valueAddedModuleData[]

object (ValueAddedModuleData)

Data modul nilai tambah opsional. Maksimum sepuluh pada objek.

EventSeat

Representasi JSON
{
  "kind": string,
  "seat": {
    object (LocalizedString)
  },
  "row": {
    object (LocalizedString)
  },
  "section": {
    object (LocalizedString)
  },
  "gate": {
    object (LocalizedString)
  }
}
Kolom
kind
(deprecated)

string

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

seat

object (LocalizedString)

Nomor kursi, seperti "1", "2", "3", atau ID kursi lainnya.

Kolom ini dapat dilokalkan sehingga Anda dapat menerjemahkan kata atau menggunakan alfabet yang berbeda untuk karakter dalam ID.

row

object (LocalizedString)

Baris kursi, seperti "1", "E", "BB", atau "A5".

Kolom ini dapat dilokalkan sehingga Anda dapat menerjemahkan kata atau menggunakan alfabet yang berbeda untuk karakter dalam ID.

section

object (LocalizedString)

Bagian kursi, seperti "121".

Kolom ini dapat dilokalkan sehingga Anda dapat menerjemahkan kata atau menggunakan alfabet yang berbeda untuk karakter dalam ID.

gate

object (LocalizedString)

Gate yang harus dilalui pemegang tiket untuk menuju ke tempat duduknya, seperti "A" atau "Barat".

Kolom ini dapat dilokalkan sehingga Anda dapat menerjemahkan kata atau menggunakan alfabet yang berbeda untuk karakter dalam ID.

EventReservationInfo

Representasi JSON
{
  "kind": string,
  "confirmationCode": string
}
Kolom
kind
(deprecated)

string

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

confirmationCode

string

Kode konfirmasi reservasi acara. Ini juga dapat berupa "nomor pesanan", "nomor konfirmasi", "nomor reservasi", atau yang setara lainnya.

Metode

addmessage

Menambahkan pesan ke objek tiket acara yang dirujuk oleh ID objek yang diberikan.

get

Menampilkan objek tiket acara dengan ID objek yang diberikan.

insert

Menyisipkan objek tiket acara dengan ID dan properti yang diberikan.

list

Menampilkan daftar semua objek tiket acara untuk ID penerbit tertentu.

modifylinkedofferobjects

Mengubah objek penawaran tertaut untuk objek tiket acara dengan ID yang diberikan.

patch

Memperbarui objek tiket acara yang dirujuk oleh ID objek yang diberikan.

update

Memperbarui objek tiket acara yang dirujuk oleh ID objek yang diberikan.