REST Resource: eventticketobject

Recurso: EventTicketObject

Representación 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)
    }
  ]
}
Campos
kind
(deprecated)

string

Identifica qué tipo de recurso es. Valor: la cadena fija "walletobjects#eventTicketObject".

classReference

object (EventTicketClass)

Es una copia de los campos heredados de la clase superior. Estos campos se recuperan durante una solicitud GET.

seatInfo

object (EventSeat)

Detalles de los asientos para esta entrada.

reservationInfo

object (EventReservationInfo)

Detalles de la reserva de este boleto Se espera que se comparta entre todos los boletos que se compraron en el mismo pedido.

ticketHolderName

string

Nombre del titular del ticket, si está asignado a una persona P.ej., "Juan Pérez" o "María Pérez".

ticketNumber

string

Es el número del ticket. Puede ser un identificador único para todos los boletos del sistema de una entidad emisora, todos los boletos del evento (p. ej., XYZ1234512345) o todos los boletos del pedido (1, 2, 3, etcétera).

ticketType

object (LocalizedString)

Es el tipo de entrada, como "Adulto", "Niño", "VIP" o "Estándar".

faceValue

object (Money)

Es el valor nominal del boleto, que coincide con lo que se imprimiría en una versión física del boleto.

groupingInfo

object (GroupingInfo)

Es la información que controla cómo se agrupan los pases.

linkedOfferIds[]

string

Es una lista de objetos de oferta vinculados a esta entrada de evento. Los objetos de oferta ya deben existir.

Los IDs de los objetos de oferta deben seguir el formato issuer ID.identifier, en el que Google emite el primero y tú eliges el segundo.

hexBackgroundColor

string

Es el color de fondo de la tarjeta. Si no se establece, se usa el color dominante de la imagen hero y, si no se establece ninguna imagen hero, se usa el color dominante del logotipo. El formato es #rrggbb, en el que rrggbb es un triplete RGB hexadecimal, como #ffcc00. También puedes usar la versión abreviada del triplete RGB, que es #rgb, como #fc0.

id

string

Obligatorio. Es el identificador único de un objeto. Este ID debe ser único para todos los objetos de un emisor. Este valor debe seguir el formato issuer ID.identifier, en el que Google emite el primero y tú eliges el segundo. El identificador único solo debe incluir caracteres alfanuméricos, ".", "_" o "-".

classId

string

Obligatorio. La clase asociada con este objeto. La clase debe ser del mismo tipo que este objeto, ya debe existir y debe estar aprobada.

Los IDs de clase deben seguir el formato issuer ID.identifier, donde Google emite el primero y tú eliges el segundo.

version
(deprecated)

string (int64 format)

Obsoleto

state

enum (State)

Obligatorio. El estado del objeto. Este campo se usa para determinar cómo se muestra un objeto en la app. Por ejemplo, un objeto inactive se mueve a la sección "Pasos vencidos".

barcode

object (Barcode)

El tipo y el valor del código de barras.

messages[]

object (Message)

Una matriz de mensajes que se muestra en la app. Todos los usuarios de este objeto recibirán los mensajes asociados. La cantidad máxima de estos campos es 10.

validTimeInterval

object (TimeInterval)

Es el período durante el cual este objeto será active y se puede usar. El estado de un objeto cambiará a expired cuando finalice este período.

locations[]
(deprecated)

object (LatLongPoint)

Nota: Por el momento, este campo no se admite para activar notificaciones geográficas.

hasUsers

boolean

Indica si el objeto tiene usuarios. La plataforma establece este campo.

smartTapRedemptionValue

string

El valor que se transmitirá a un terminal certificado por Smart Tap mediante NFC para este objeto. Los campos a nivel de la clase enableSmartTap y redemptionIssuers también deben configurarse correctamente para que el pase admita el Toque inteligente. Solo se admiten caracteres ASCII.

hasLinkedDevice

boolean

Indica si este objeto está vinculado actualmente a un solo dispositivo. La plataforma establece este campo cuando un usuario guarda el objeto y lo vincula a su dispositivo. Está destinado a socios seleccionados. Comunícate con el equipo de asistencia para obtener más información.

disableExpirationNotification

boolean

Indica si se deben suprimir las notificaciones de forma explícita. Si se establece este campo como verdadero, independientemente del campo messages, se suprimirán las notificaciones de vencimiento que envíe al usuario. De forma predeterminada, este campo se establece en falso.

Por el momento, solo se puede configurar para las ofertas.

infoModuleData

object (InfoModuleData)

Obsoleta. En su lugar, usa textModulesData.

imageModulesData[]

object (ImageModuleData)

Datos del módulo de imagen. La cantidad máxima de estos campos que se muestran es 1 desde el nivel de objeto y 1 para el nivel de objeto de clase.

textModulesData[]

object (TextModuleData)

Datos del módulo de texto Si también se definen datos del módulo de texto en la clase, se mostrarán ambos. La cantidad máxima de estos campos que se muestran es de 10 del objeto y 10 de la clase.

rotatingBarcode

object (RotatingBarcode)

El tipo y el valor del código de barras rotativo.

heroImage

object (Image)

Es la imagen de banner opcional que se muestra en la parte frontal de la tarjeta. Si no hay ninguna, se mostrará la imagen hero de la clase, si está presente. Si tampoco está presente la imagen hero de la clase, no se mostrará nada.

passConstraints

object (PassConstraints)

Pasa las restricciones del objeto. Incluye la limitación de los comportamientos de NFC y capturas de pantalla.

saveRestrictions

object (SaveRestrictions)

Son restricciones sobre el objeto que se deben verificar antes de que el usuario intente guardar el pase. Ten en cuenta que estas restricciones solo se aplicarán durante el tiempo de ahorro. Si las restricciones cambian después de que un usuario guarda un pase, las restricciones nuevas no se aplicarán a un pase ya guardado.

linkedObjectIds[]

string

linkedObjectIds es una lista de otros objetos, como entradas para eventos, lealtad, ofertas, genéricos, tarjetas de regalo, transporte público y tarjetas de embarque, que se deben adjuntar automáticamente a este objeto de entrada para eventos. Si un usuario hubiera guardado esta entrada para el evento, estos linkedObjectIds se enviarían automáticamente a la billetera del usuario (a menos que haya desactivado el parámetro de configuración para recibir esos pases vinculados).

Asegúrate de que los objetos presentes en linkedObjectIds ya estén insertados. De lo contrario, las llamadas fallarán. Una vez vinculados, los objetos vinculados no se pueden desvincular. No puedes vincular objetos que pertenezcan a otro emisor. Existe un límite para la cantidad de objetos que se pueden vincular a un solo objeto. Una vez que se alcance el límite, se ignorarán en silencio los objetos vinculados nuevos en la llamada.

Los IDs de objeto deben seguir el formato issuer ID.identifier, donde Google emite el primero y tú eliges el segundo.

notifyPreference

enum (NotificationSettingsForUpdates)

Indica si las actualizaciones de campos de este objeto deben activar notificaciones. Cuando se configura como NOTIFY, intentaremos activar una notificación de actualización de campo para los usuarios. Estas notificaciones solo se enviarán a los usuarios si el campo forma parte de una lista de entidades permitidas. Si se establece en DO_NOT_NOTIFY o NOTIFICATION_SETTINGS_UNSPECIFIED, no se activará ninguna notificación. Este parámetro de configuración es efímero y se debe establecer con cada solicitud PATCH o UPDATE. De lo contrario, no se activará una notificación.

valueAddedModuleData[]

object (ValueAddedModuleData)

Datos opcionales del módulo de valor agregado. Máximo de diez en el objeto.

EventSeat

Representación JSON
{
  "kind": string,
  "seat": {
    object (LocalizedString)
  },
  "row": {
    object (LocalizedString)
  },
  "section": {
    object (LocalizedString)
  },
  "gate": {
    object (LocalizedString)
  }
}
Campos
kind
(deprecated)

string

Identifica qué tipo de recurso es. Valor: la cadena fija "walletobjects#eventSeat".

seat

object (LocalizedString)

El número de asiento, como "1", "2", "3" o cualquier otro identificador de asiento

Este campo es localizable, por lo que puedes traducir palabras o usar diferentes alfabetos para los caracteres de un identificador.

row

object (LocalizedString)

Es la fila del asiento, como “1”, “E”, “BB” o “A5”.

Este campo es localizable, por lo que puedes traducir palabras o usar diferentes alfabetos para los caracteres de un identificador.

section

object (LocalizedString)

Es la sección del asiento, como "121".

Este campo es localizable, por lo que puedes traducir palabras o usar diferentes alfabetos para los caracteres de un identificador.

gate

object (LocalizedString)

La puerta por la que debe ingresar el titular de la entrada para llegar a su asiento, como "A" o "Oeste"

Este campo es localizable, por lo que puedes traducir palabras o usar diferentes alfabetos para los caracteres de un identificador.

EventReservationInfo

Representación JSON
{
  "kind": string,
  "confirmationCode": string
}
Campos
kind
(deprecated)

string

Identifica qué tipo de recurso es. Valor: la cadena fija "walletobjects#eventReservationInfo".

confirmationCode

string

El código de confirmación de la reserva del evento También puede ser un “número de pedido”, “número de confirmación”, “número de reserva” o algún otro equivalente.

Métodos

addmessage

Agrega un mensaje al objeto de boleto de evento al que hace referencia el ID de objeto determinado.

get

Devuelve el objeto de entrada para evento con el ID de objeto dado.

insert

Inserta un objeto de entrada para evento con el ID y las propiedades especificados.

list

Devuelve una lista de todos los objetos de entradas para eventos de un ID de entidad emisora determinado.

modifylinkedofferobjects

Modifica los objetos de oferta vinculados para el objeto de boleto de evento con el ID determinado.

patch

Actualiza el objeto de ticket de evento al que hace referencia el ID de objeto determinado.

update

Actualiza el objeto de ticket de evento al que hace referencia el ID de objeto determinado.