REST Resource: eventticketobject

Kaynak: EventTicketObject

JSON gösterimi
{
  "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)
    }
  ]
}
Alanlar
kind
(deprecated)

string

Bu kaynağın ne tür olduğunu tanımlar. Değer: "walletobjects#eventTicketObject" sabit dizesi.

classReference

object (EventTicketClass)

Üst sınıfın devralınan alanlarının bir kopyası. Bu alanlar GET sırasında alınır.

seatInfo

object (EventSeat)

Bu biletin koltuk bilgileri.

reservationInfo

object (EventReservationInfo)

Bu biletin rezervasyon ayrıntıları. Bunun, aynı siparişte satın alınan tüm biletler arasında paylaşılması beklenir.

ticketHolderName

string

Bilet bir kişiye atanmışsa bilet sahibinin adı. Ör. "Can Bilgili" veya "Canan Bilgili".

ticketNumber

string

Biletin numarası. Bu, bir ihraççının sistemindeki tüm biletler, etkinlikle ilgili tüm biletler (ör. XYZ1234512345) veya siparişteki tüm biletler (1, 2, 3 vb.) için benzersiz bir tanımlayıcı olabilir.

ticketType

object (LocalizedString)

Biletin türü (ör. "Yetişkin", "Çocuk", "VIP" veya "Standart").

faceValue

object (Money)

Biletin fiziksel sürümünde basılan değerle eşleşen biletin nominal değeri.

groupingInfo

object (GroupingInfo)

Kartların nasıl gruplandırılacağını kontrol eden bilgiler.

linkedOfferIds[]

string

Bu etkinlik biletine bağlı fırsat nesnelerinin listesi. Teklif nesneleri zaten mevcut olmalıdır.

Teklif nesne kimlikleri issuer ID biçimini izlemelidir.identifier burada Google tarafından verilir, ikincisi ise sizin tarafınızdan seçilir.

hexBackgroundColor

string

Kartın arka plan rengi. Ayarlanmamışsa hero resminin baskın rengi, hero resmi ayarlanmamışsa logonun baskın rengi kullanılır. Biçim #rrggbb şeklindedir. Burada rrggbb, #ffcc00 gibi bir onaltılık RGB üçlüsüdür. RGB üçlüsünün kısaltılmış versiyonunu da kullanabilirsiniz. Bu kısaltma #rgb şeklindedir (ör. #fc0).

id

string

Zorunlu. Bir nesnenin benzersiz tanımlayıcısıdır. Bu kimlik, bir kartı veren kuruluşa ait tüm nesneler arasında benzersiz olmalıdır. Bu değer issuer ID biçiminde olmalıdır.identifier. Bunlardan ilki Google tarafından verilir, ikincisi ise sizin tarafınızdan seçilir. Benzersiz tanımlayıcı yalnızca alfanümerik karakterler, ".", "_" veya "-" içermelidir.

classId

string

Zorunlu. Bu nesneyle ilişkili sınıf. Sınıf, bu nesneyle aynı türde olmalı, zaten mevcut olmalı ve onaylanmalıdır.

Sınıf kimlikleri issuer ID biçimini izlemelidir.identifier. Bunlardan ilki Google tarafından verilir, ikincisi ise sizin tarafınızdan seçilir.

version
(deprecated)

string (int64 format)

Kullanımdan kaldırıldı

state

enum (State)

Zorunlu. Nesnenin durumu. Bu alan, bir nesnenin uygulamada nasıl gösterileceğini belirlemek için kullanılır. Örneğin, bir inactive nesnesi "Süresi dolmuş kartlar" bölümüne taşınır.

barcode

object (Barcode)

Barkod türü ve değeri.

messages[]

object (Message)

Uygulamada görüntülenen bir mesaj dizisi. Bu nesnenin tüm kullanıcıları, nesneyle ilişkilendirilmiş mesajları alır. Bu alanlar en fazla 10 tane olabilir.

validTimeInterval

object (TimeInterval)

Bu nesnenin active olacağı ve nesnenin kullanılabileceği dönem. Bu süre geçtiğinde nesnenin durumu expired olarak değiştirilir.

locations[]
(deprecated)

object (LatLongPoint)

Not: Bu alan şu anda coğrafi bildirimleri tetiklemek için desteklenmemektedir.

hasUsers

boolean

Nesnenin kullanıcısı olup olmadığını belirtir. Bu alan platform tarafından ayarlanır.

smartTapRedemptionValue

string

Bu nesne için NFC üzerinden Smart Tap sertifikalı bir terminale iletilecek değer. Kartın Akıllı Ödeme'yi desteklemesi için enableSmartTap ve redemptionIssuers sınıf düzeyi alanlarının da doğru şekilde ayarlanması gerekir. Yalnızca ASCII karakterler desteklenir.

hasLinkedDevice

boolean

Bu nesnenin şu anda tek bir cihaza bağlı olup olmadığı. Bu alan, kullanıcı nesneyi kaydedip cihazına bağladığında platform tarafından ayarlanır. Belirli iş ortakları tarafından kullanılmak üzere tasarlanmıştır. Daha fazla bilgi için destek ekibiyle iletişime geçin.

disableExpirationNotification

boolean

Bildirimlerin açıkça engellenip engellenmeyeceğini belirtir. Bu alan doğru değerine ayarlanırsa messages alanından bağımsız olarak kullanıcıya gönderilen süre sonu bildirimleri atlanır. Bu alan varsayılan olarak "false" (yanlış) değerine ayarlıdır.

Bu özellik şu anda yalnızca teklifler için ayarlanabilir.

infoModuleData

object (InfoModuleData)

Kullanımdan kaldırıldı. Bunun yerine textModulesData parametresini kullanın.

imageModulesData[]

object (ImageModuleData)

Resim modülü verileri. Bu alanlar, nesne düzeyinde 1'i, sınıf nesnesi düzeyinde ise 1'i gösterebilir.

textModulesData[]

object (TextModuleData)

Metin modülü verileri. Sınıfta metin modülü verileri de tanımlanmışsa her ikisi de gösterilir. Bu alanların gösterilen maksimum sayısı, nesneden 10 ve sınıftan 10'dur.

rotatingBarcode

object (RotatingBarcode)

Dönen barkod türü ve değeri.

heroImage

object (Image)

Kartın ön tarafında gösterilen isteğe bağlı banner resmi. Hiçbiri yoksa sınıfın hero resmi (varsa) gösterilir. Sınıfın hero resmi de yoksa hiçbir şey gösterilmez.

passConstraints

object (PassConstraints)

Nesne için kısıtlamaları iletin. NFC ve ekran görüntüsü davranışlarını sınırlama da buna dahildir.

saveRestrictions

object (SaveRestrictions)

Kullanıcının kartı kaydetmeye çalışmadan önce doğrulanması gereken nesneyle ilgili kısıtlamalar. Bu kısıtlamaların yalnızca kayıt sırasında uygulanacağını unutmayın. Kullanıcı kartı kaydettikten sonra kısıtlamalar değişirse yeni kısıtlamalar daha önce kaydedilmiş kartlara uygulanmaz.

linkedObjectIds[]

string

linkedObjectIds, bu etkinlik bileti nesnesine otomatik olarak eklenmesi gereken etkinlik bileti, bağlılık, teklif, genel, hediye kartı, toplu taşıma ve biniş kartı gibi diğer nesnelerin bir listesidir. Bir kullanıcı bu etkinlik biletini kaydettiyse bu linkedObjectIds, kullanıcının cüzdanına otomatik olarak gönderilir (bu tür bağlı kartları alma ayarını devre dışı bırakmadığı sürece).

linkedObjectIds'de bulunan nesnelerin zaten eklendiğinden emin olun. Aksi takdirde çağrılar başarısız olur. Bağlı nesnelerin bağlantısı kaldırılamaz. Başka bir verene ait nesneleri bağlayamazsınız. Tek bir nesneye bağlanabilecek nesne sayısı sınırlıdır. Sınıra ulaşıldığında görüşmedeki yeni bağlı nesneler sessizce yoksayılır.

Nesne kimlikleri issuer ID biçimini izlemelidir.identifier. Bunlardan ilki Google tarafından, ikincisi ise sizin tarafınızdan seçilir.

notifyPreference

enum (NotificationSettingsForUpdates)

Bu nesneyle ilgili alan güncellemelerinin bildirim tetiklemesi gerekip gerekmediği. NOTIFY olarak ayarlandığında, kullanıcılara alan güncelleme bildirimi göndermeye çalışırız. Bu bildirimler yalnızca ilgili alan bir izin verilenler listesinde yer alıyorsa kullanıcılara gönderilir. DO_NOT_NOTIFY veya NOTIFICATION_SETTINGS_UNSPECIFIED olarak ayarlanırsa bildirim tetiklenmez. Bu ayar geçicidir ve her PATCH veya UPDATE isteğiyle birlikte ayarlanması gerekir. Aksi takdirde bildirim tetiklenmez.

valueAddedModuleData[]

object (ValueAddedModuleData)

İsteğe bağlı katma değer modülü verileri. Nesnede en fazla on tane olabilir.

EventSeat

JSON gösterimi
{
  "kind": string,
  "seat": {
    object (LocalizedString)
  },
  "row": {
    object (LocalizedString)
  },
  "section": {
    object (LocalizedString)
  },
  "gate": {
    object (LocalizedString)
  }
}
Alanlar
kind
(deprecated)

string

Bu kaynağın ne tür olduğunu tanımlar. Değer: "walletobjects#eventSeat" sabit dizesi.

seat

object (LocalizedString)

Koltuk numarası ("1", "2", "3" gibi) veya başka bir koltuk tanımlayıcısı.

Bu alan yerelleştirilebilir. Dolayısıyla, kelimeleri çevirebilir veya bir tanımlayıcıdaki karakterler için farklı alfabeler kullanabilirsiniz.

row

object (LocalizedString)

Koltuğun bulunduğu satır ("1", "E", "BB" veya "A5" gibi).

Bu alan yerelleştirilebilir. Dolayısıyla, kelimeleri çevirebilir veya bir tanımlayıcıdaki karakterler için farklı alfabeler kullanabilirsiniz.

section

object (LocalizedString)

Koltuğun bölümü (ör. "121").

Bu alan yerelleştirilebilir. Böylece kelimeleri çevirebilir veya tanımlayıcıdaki karakterler için farklı alfabeler kullanabilirsiniz.

gate

object (LocalizedString)

Bilet sahibinin koltuğuna gitmek için girmesi gereken kapı (ör. "A" veya "Batı").

Bu alan yerelleştirilebilir. Böylece, kelimeleri çevirebilir veya tanımlayıcıdaki karakterler için farklı alfabeler kullanabilirsiniz.

EventReservationInfo

JSON gösterimi
{
  "kind": string,
  "confirmationCode": string
}
Alanlar
kind
(deprecated)

string

Bunun ne tür bir kaynak olduğunu tanımlar. Değer: "walletobjects#eventReservationInfo" sabit dizesi.

confirmationCode

string

Etkinlik rezervasyonunun onay kodu. Bu numara "sipariş numarası", "onay numarası", "rezervasyon numarası" veya eşdeğer bir biçimde de olabilir.

Yöntemler

addmessage

Belirtilen nesne kimliği tarafından referans verilen etkinlik bileti nesnesine bir mesaj ekler.

get

Belirtilen nesne kimliğine sahip etkinlik bileti nesnesini döndürür.

insert

Belirtilen kimliğe ve özelliklere sahip bir etkinlik bileti nesnesi ekler.

list

Belirli bir veren kimliği için tüm etkinlik bileti nesnelerinin listesini döndürür.

modifylinkedofferobjects

Belirtilen kimliğe sahip etkinlik bileti nesnesi için bağlı teklif nesnelerini değiştirir.

patch

Belirtilen nesne kimliği tarafından referans verilen etkinlik bileti nesnesini günceller.

update

Belirtilen nesne kimliğinin referans verdiği etkinlik bileti nesnesini günceller.