REST Resource: eventticketclass

Recurso: EventTicketClass

Representación JSON
{
  "kind": string,
  "eventName": {
    object (LocalizedString)
  },
  "eventId": string,
  "logo": {
    object (Image)
  },
  "venue": {
    object (EventVenue)
  },
  "dateTime": {
    object (EventDateTime)
  },
  "confirmationCodeLabel": enum (ConfirmationCodeLabel),
  "customConfirmationCodeLabel": {
    object (LocalizedString)
  },
  "seatLabel": enum (SeatLabel),
  "customSeatLabel": {
    object (LocalizedString)
  },
  "rowLabel": enum (RowLabel),
  "customRowLabel": {
    object (LocalizedString)
  },
  "sectionLabel": enum (SectionLabel),
  "customSectionLabel": {
    object (LocalizedString)
  },
  "gateLabel": enum (GateLabel),
  "customGateLabel": {
    object (LocalizedString)
  },
  "finePrint": {
    object (LocalizedString)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "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),
  "wideLogo": {
    object (Image)
  },
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "appLinkData": {
    object (AppLinkData)
  },
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
Campos
kind
(deprecated)

string

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

eventName

object (LocalizedString)

Obligatorio. Es el nombre del evento, como "LA Dodgers at SF Giants".

eventId

string

El ID del evento. Este ID debe ser único para cada evento de una cuenta. Se usa para agrupar entradas si el usuario guardó varias para el mismo evento. Puede tener un máximo de 64 caracteres.

Si se proporciona, la agrupación será estable. Ten cuidado con las colisiones no intencionales para evitar agrupar tickets que no deban agruparse. Si usas solo una clase por evento, puedes configurar esto como classId (con o sin la parte del ID de la entidad emisora).

Si no se proporcionan, la plataforma intentará usar otros datos para agrupar los tickets (posiblemente inestables).

venue

object (EventVenue)

Detalles del lugar del evento

dateTime

object (EventDateTime)

La información de la fecha y hora del evento.

confirmationCodeLabel

enum (ConfirmationCodeLabel)

Es la etiqueta que se usará para el valor del código de confirmación (eventTicketObject.reservationInfo.confirmationCode) en la vista de detalles de la tarjeta. Cada opción disponible se asigna a un conjunto de cadenas localizadas para que las traducciones se muestren al usuario según su configuración regional.

Es posible que no se establezcan confirmationCodeLabel ni customConfirmationCodeLabel. Si no se establece ninguno, la etiqueta predeterminada será "Confirmation Code", localizada. Si no se establece el campo de código de confirmación, no se usará esta etiqueta.

customConfirmationCodeLabel

object (LocalizedString)

Es una etiqueta personalizada que se usa para el valor del código de confirmación (eventTicketObject.reservationInfo.confirmationCode) en la vista de detalles de la tarjeta. Solo debe usarse si la etiqueta predeterminada "Código de confirmación" o una de las opciones de confirmationCodeLabel no es suficiente.

Es posible que no se establezcan confirmationCodeLabel ni customConfirmationCodeLabel. Si no se establece ninguno, la etiqueta se establecerá de forma predeterminada en "Código de confirmación", localizado. Si no se establece el campo de código de confirmación, no se usará esta etiqueta.

seatLabel

enum (SeatLabel)

Es la etiqueta que se usará para el valor del asiento (eventTicketObject.seatInfo.seat) en la vista de detalles de la tarjeta. Cada opción disponible se asigna a un conjunto de cadenas localizadas para que las traducciones se muestren al usuario según su configuración regional.

Es posible que no se establezcan seatLabel ni customSeatLabel. Si no se establece ninguno, la etiqueta se establecerá de forma predeterminada en "Asiento", localizado. Si no se establece el campo de asiento, no se usará esta etiqueta.

customSeatLabel

object (LocalizedString)

Es una etiqueta personalizada que se usa para el valor del asiento (eventTicketObject.seatInfo.seat) en la vista de detalles de la tarjeta. Solo debe usarse si la etiqueta predeterminada "Asiento" o una de las opciones seatLabel no es suficiente.

Es posible que no se hayan configurado seatLabel ni customSeatLabel. Si no se establece ninguno, la etiqueta se establecerá de forma predeterminada en "Asiento", localizado. Si no se establece el campo de asiento, no se usará esta etiqueta.

rowLabel

enum (RowLabel)

Es la etiqueta que se usará para el valor de la fila (eventTicketObject.seatInfo.row) en la vista de detalles de la tarjeta. Cada opción disponible se asigna a un conjunto de cadenas localizadas, de modo que las traducciones se muestran al usuario en función de su configuración regional.

Es posible que no se establezcan rowLabel ni customRowLabel. Si no se establece ninguno, la etiqueta se establecerá de forma predeterminada en “Fila”, localizada. Si no se establece el campo de fila, no se usará esta etiqueta.

customRowLabel

object (LocalizedString)

Es una etiqueta personalizada que se usará para el valor de la fila (eventTicketObject.seatInfo.row) en la vista de detalles de la tarjeta. Solo debe usarse si la etiqueta predeterminada "Row" o una de las opciones rowLabel no es suficiente.

Es posible que no se establezcan rowLabel ni customRowLabel. Si no se establece ninguno, la etiqueta se establecerá de forma predeterminada en "Fila", localizada. Si no estableces el campo de fila, no se usará esta etiqueta.

sectionLabel

enum (SectionLabel)

Es la etiqueta que se usará para el valor de la sección (eventTicketObject.seatInfo.section) en la vista de detalles de la tarjeta. Cada opción disponible se asigna a un conjunto de cadenas localizadas para que las traducciones se muestren al usuario según su configuración regional.

Es posible que no se establezcan sectionLabel ni customSectionLabel. Si no se establece ninguno, la etiqueta se establecerá de forma predeterminada en "Sección", localizada. Si no se establece el campo de sección, no se usará esta etiqueta.

customSectionLabel

object (LocalizedString)

Es una etiqueta personalizada que se usará para el valor de la sección (eventTicketObject.seatInfo.section) en la vista de detalles de la tarjeta. Solo debe usarse si la etiqueta predeterminada “Sección” o una de las opciones de sectionLabel no es suficiente.

Es posible que no se establezcan sectionLabel ni customSectionLabel. Si no se establece ninguno, la etiqueta se establecerá de forma predeterminada en "Sección", localizada. Si no se establece el campo de sección, no se usará esta etiqueta.

gateLabel

enum (GateLabel)

Es la etiqueta que se usará para el valor de la puerta (eventTicketObject.seatInfo.gate) en la vista de detalles de la tarjeta. Cada opción disponible se asigna a un conjunto de cadenas localizadas para que las traducciones se muestren al usuario según su configuración regional.

Es posible que no se establezcan gateLabel ni customGateLabel. Si no se establece ninguno, la etiqueta se establecerá de forma predeterminada en "Puerta", localizada. Si no se establece el campo de puerta, no se usará esta etiqueta.

customGateLabel

object (LocalizedString)

Es una etiqueta personalizada que se usa para el valor de la puerta de enlace (eventTicketObject.seatInfo.gate) en la vista de detalles de la tarjeta. Solo debe usarse si la etiqueta "Puerta" predeterminada o una de las opciones de gateLabel no es suficiente.

Es posible que no se establezcan gateLabel ni customGateLabel. Si no se establece ninguno, la etiqueta se establecerá de forma predeterminada en "Puerta", localizada. Si no se establece el campo de puerta, no se usará esta etiqueta.

finePrint

object (LocalizedString)

La letra chica, los términos o las condiciones del boleto

classTemplateInfo

object (ClassTemplateInfo)

Información de la plantilla sobre cómo se debe mostrar la clase. Si no se establece, Google usará un conjunto predeterminado de campos para mostrar.

id

string

Obligatorio. Es el identificador único de una clase. Este ID debe ser único para todas las clases de un emisor. Este valor debe seguir el formato issuer ID.identifier, en el que Google emite el primero y tú eliges el segundo. Tu identificador único solo debe incluir caracteres alfanuméricos, '.', '_' o '-'.

version
(deprecated)

string (int64 format)

Obsoleto

issuerName

string

Obligatorio. Es el nombre de la entidad emisora. La longitud máxima recomendada es de 20 caracteres para garantizar que la cadena completa se muestre en las pantallas más pequeñas.

messages[]

object (Message)

Es un array de mensajes que se muestran en la app. Todos los usuarios de este objeto recibirán los mensajes asociados. La cantidad máxima de estos campos es 10.

allowMultipleUsersPerObject
(deprecated)

boolean

Obsoleta. Usa multipleDevicesAndHoldersAllowedStatus en su lugar.

homepageUri

object (Uri)

Es el URI de la página principal de tu aplicación. Cuando se propaga el URI en este campo, se produce exactamente el mismo comportamiento que cuando se propaga un URI en linksModuleData (cuando se renderiza un objeto, se muestra un vínculo a la página principal en lo que normalmente se consideraría la sección linksModuleData del objeto).

locations[]
(deprecated)

object (LatLongPoint)

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

reviewStatus

enum (ReviewStatus)

Obligatorio. Es el estado de la clase. Este campo se puede establecer en draft o underReview mediante las llamadas a la API de insertar, aplicar parches o actualizar. Una vez que se cambia el estado de la revisión de draft, es posible que no se pueda volver a cambiar a draft.

Debes mantener este campo en draft cuando la clase esté en desarrollo. No se puede usar una clase draft para crear ningún objeto.

Debes establecer este campo en underReview cuando creas que la clase está lista para usarse. La plataforma establecerá automáticamente este campo en approved y se podrá usar de inmediato para crear o migrar objetos.

Cuando actualices una clase que ya es approved, debes seguir configurando este campo como underReview.

review

object (Review)

Los comentarios de las opiniones que establece la plataforma cuando se marca una clase como approved o rejected.

infoModuleData
(deprecated)

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 muestra es 1 a nivel del objeto y 1 a nivel del objeto de clase.

textModulesData[]

object (TextModuleData)

Datos del módulo de texto Si los datos del módulo de texto también se definen 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.

redemptionIssuers[]

string (int64 format)

Identifica qué emisores de canje pueden canjear el pase a través de Smart Tap. Las entidades emisoras de canjes se identifican por su ID de emisor. Los emisores de canje deben tener configurada al menos una clave de Smart Tap.

Los campos enableSmartTap y smartTapRedemptionLevel a nivel del objeto también deben configurarse correctamente para que un pase admita el Toque inteligente.

countryCode

string

Es el código de país que se usa para mostrar el país de la tarjeta (cuando el usuario no está en ese país) y contenido localizado cuando el contenido no está disponible en la configuración regional del usuario.

heroImage

object (Image)

Es la imagen de banner opcional que se muestra en la parte frontal de la tarjeta. Si no hay ninguno, no se mostrará nada. La imagen se mostrará al 100% de ancho.

wordMark
(deprecated)

object (Image)

Obsoleta.

enableSmartTap

boolean

Identifica si esta clase admite el Presionar con el dedo inteligente. Los campos redemptionIssuers y smartTapRedemptionLevel a nivel del objeto también deben configurarse correctamente para que un pase admita el Toque inteligente.

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.

localizedIssuerName

object (LocalizedString)

Cadenas traducidas para issuerName. La longitud máxima recomendada es de 20 caracteres para garantizar que se muestre la cadena completa en pantallas más pequeñas.

multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

Identifica si varios usuarios y dispositivos guardarán el mismo objeto que hace referencia a esta clase.

callbackOptions

object (CallbackOptions)

Opciones de devolución de llamada que se usarán para devolver la llamada a la entidad emisora cada vez que el usuario final guarde o borre un objeto de esta clase. Todos los objetos de esta clase son aptos para la devolución de llamada.

securityAnimation

object (SecurityAnimation)

Información opcional sobre la animación de seguridad. Si se establece, se renderizará una animación de seguridad en los detalles del pase.

viewUnlockRequirement

enum (ViewUnlockRequirement)

Consulta las opciones de requisitos de desbloqueo para la entrada del evento.

notifyPreference

enum (NotificationSettingsForUpdates)

Si las actualizaciones de campo de esta clase deben activar notificaciones o no. Cuando se establece en 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 no se especifica, 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. Se permite un máximo de diez personas en la clase. Para un pase, solo se mostrarán diez, dando prioridad a los del objeto.

EventVenue

Representación JSON
{
  "kind": string,
  "name": {
    object (LocalizedString)
  },
  "address": {
    object (LocalizedString)
  }
}
Campos
kind
(deprecated)

string

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

name

object (LocalizedString)

Es el nombre del lugar, como "AT&T Park".

Esto es obligatorio.

address

object (LocalizedString)

La dirección del lugar, como “24 Willie Mays Plaza\nSan Francisco, CA 94107”. Las líneas de dirección están separadas por caracteres de salto de línea (\n).

Esto es obligatorio.

EventDateTime

Representación JSON
{
  "kind": string,
  "doorsOpen": string,
  "start": string,
  "end": string,
  "doorsOpenLabel": enum (DoorsOpenLabel),
  "customDoorsOpenLabel": {
    object (LocalizedString)
  }
}
Campos
kind
(deprecated)

string

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

doorsOpen

string

Es la fecha y hora en que se abren las puertas del lugar.

Es una fecha y hora en formato extendido ISO 8601, con o sin un desfase. El tiempo se puede especificar con una precisión de nanosegundos. Los desfases se pueden especificar con precisión de segundos (aunque los segundos de desfase no forman parte del estándar ISO 8601).

Por ejemplo:

1985-04-12T23:20:50.52Z sería 20 minutos y 50.52 segundos después de la hora 23 del 12 de abril de 1985 en UTC.

1985-04-12T19:20:50.52-04:00 sería 20 minutos y 50.52 segundos después de la hora 19 del 12 de abril de 1985, 4 horas antes de la UTC (mismo instante que el ejemplo anterior). Si el evento fuera en Nueva York, sería el equivalente a la hora de verano del este (EDT). Recuerda que el desfase varía en las regiones que observan el horario de verano, según la época del año.

1985-04-12T19:20:50.52 estaría 20 minutos y 50.52 segundos después de la hora 19 del 12 de abril de 1985 sin información de compensación.

La parte de la fecha y hora sin el desplazamiento se considera como la "fecha y hora locales". Debe ser la fecha y hora locales del lugar. Por ejemplo, si el evento ocurre a las 8 p.m. del 5 de junio de 2018 en el lugar, la parte de fecha y hora local debe ser 2018-06-05T20:00:00. Si la fecha y hora locales del lugar son 4 horas antes de la UTC, se puede agregar una compensación de -04:00.

Sin información de compensación, es posible que algunas funciones enriquecidas no estén disponibles.

start

string

La fecha y hora en que comienza el evento. Si el evento abarca varios días, debe ser la fecha y hora de inicio del primer día.

Esta es una fecha y hora de formato extendido ISO 8601, con o sin desplazamiento. El tiempo se puede especificar con una precisión de nanosegundos. Los desfases se pueden especificar con precisión de segundos (aunque los segundos de desfase no forman parte del estándar ISO 8601).

Por ejemplo:

1985-04-12T23:20:50.52Z sería 20 minutos y 50.52 segundos después de la hora 23 del 12 de abril de 1985 en UTC.

1985-04-12T19:20:50.52-04:00 sería 20 minutos y 50.52 segundos después de la hora 19 del 12 de abril de 1985, 4 horas antes de la UTC (mismo instante que el ejemplo anterior). Si el evento fuera en Nueva York, sería el equivalente a la hora de verano del este (EDT). Recuerda que el desfase varía en las regiones que observan el horario de verano, según la época del año.

1985-04-12T19:20:50.52 estaría 20 minutos y 50.52 segundos después de la hora 19 del 12 de abril de 1985 sin información de compensación.

La parte de la fecha y hora sin el desplazamiento se considera como la "fecha y hora locales". Debe ser la fecha y hora locales del lugar. Por ejemplo, si el evento ocurre a las 8 p.m. del 5 de junio de 2018 en el lugar, la parte de fecha y hora local debe ser 2018-06-05T20:00:00. Si la fecha y hora locales del lugar son 4 horas antes de la UTC, se puede agregar una compensación de -04:00.

Sin información de compensación, es posible que algunas funciones enriquecidas no estén disponibles.

end

string

Fecha y hora de finalización del evento. Si el evento abarca varios días, debe ser la fecha y hora de finalización del último día.

Es una fecha y hora en formato extendido ISO 8601, con o sin un desfase. El tiempo se puede especificar con una precisión de nanosegundos. Los desplazamientos se pueden especificar con precisión de segundos (aunque los segundos de desplazamiento no formen parte de ISO 8601).

Por ejemplo:

1985-04-12T23:20:50.52Z sería 20 minutos y 50.52 segundos después de la hora 23 del 12 de abril de 1985 en UTC.

1985-04-12T19:20:50.52-04:00 sería 20 minutos y 50.52 segundos después de la hora 19 del 12 de abril de 1985, 4 horas antes de la UTC (mismo instante que el ejemplo anterior). Si el evento fuera en Nueva York, sería el equivalente a la hora de verano del este (EDT). Recuerda que el desfase varía en las regiones que observan el horario de verano, según la época del año.

1985-04-12T19:20:50.52 estaría 20 minutos y 50.52 segundos después de la hora 19 del 12 de abril de 1985 sin información de compensación.

La parte de la fecha y hora sin el desplazamiento se considera como la "fecha y hora locales". Debe ser la fecha y hora locales del lugar. Por ejemplo, si el evento ocurre a las 8 p.m. del 5 de junio de 2018 en el lugar, la parte de fecha y hora local debe ser 2018-06-05T20:00:00. Si la fecha y hora locales del lugar son 4 horas antes de la UTC, se puede agregar una compensación de -04:00.

Sin información de compensación, es posible que algunas funciones enriquecidas no estén disponibles.

doorsOpenLabel

enum (DoorsOpenLabel)

Es la etiqueta que se usará para el valor de puertas abiertas (doorsOpen) en la vista de detalles de la tarjeta. Cada opción disponible se asigna a un conjunto de cadenas localizadas para que las traducciones se muestren al usuario según su configuración regional.

Es posible que no se establezcan doorsOpenLabel ni customDoorsOpenLabel. Si no estableces ninguno, la etiqueta se establecerá de forma predeterminada como "Puertas abiertas", localizada. Si no se establece el campo de puertas abiertas, no se usará esta etiqueta.

customDoorsOpenLabel

object (LocalizedString)

Una etiqueta personalizada que se usará para el valor de puertas abiertas (doorsOpen) en la vista de detalles de la tarjeta. Solo debe usarse si la etiqueta predeterminada "Puertas abiertas" o una de las opciones doorsOpenLabel no es suficiente.

Es posible que no se establezcan doorsOpenLabel ni customDoorsOpenLabel. Si no estableces ninguno, la etiqueta se establecerá de forma predeterminada como "Puertas abiertas", localizada. Si no se establece el campo de puertas abiertas, no se usará esta etiqueta.

DoorsOpenLabel

Enumeraciones
DOORS_OPEN_LABEL_UNSPECIFIED
DOORS_OPEN
doorsOpen

Alias heredado de DOORS_OPEN. Obsoleta.

GATES_OPEN
gatesOpen

Alias heredado de GATES_OPEN. Obsoleta.

ConfirmationCodeLabel

Enumeraciones
CONFIRMATION_CODE_LABEL_UNSPECIFIED
CONFIRMATION_CODE
confirmationCode

Es el alias heredado de CONFIRMATION_CODE. Obsoleta.

CONFIRMATION_NUMBER
confirmationNumber

Es el alias heredado de CONFIRMATION_NUMBER. Obsoleta.

ORDER_NUMBER
orderNumber

Es el alias heredado de ORDER_NUMBER. Obsoleta.

RESERVATION_NUMBER
reservationNumber

Alias heredado de RESERVATION_NUMBER. Obsoleta.

SeatLabel

Enumeraciones
SEAT_LABEL_UNSPECIFIED
SEAT
seat

Es el alias heredado de SEAT. Obsoleta.

RowLabel

Enumeraciones
ROW_LABEL_UNSPECIFIED
ROW
row

Es el alias heredado de ROW. Obsoleta.

SectionLabel

Enumeraciones
SECTION_LABEL_UNSPECIFIED
SECTION
section

Alias heredado de SECTION. Obsoleta.

THEATER
theater

Es el alias heredado de THEATER. Obsoleta.

GateLabel

Enumeraciones
GATE_LABEL_UNSPECIFIED
GATE
gate

Es el alias heredado de GATE. Obsoleta.

DOOR
door

Alias heredado de DOOR. Obsoleta.

ENTRANCE
entrance

Es el alias heredado de ENTRANCE. Obsoleta.

Métodos

addmessage

Agrega un mensaje a la clase de entradas del evento a la que hace referencia el ID de clase determinado.

get

Muestra la clase de entrada para evento con el ID de clase determinado.

insert

Inserta una clase de entrada de evento con el ID y las propiedades determinados.

list

Muestra una lista de todas las clases de boletos de eventos para un ID de emisor determinado.

patch

Actualiza la clase de entradas para eventos a la que hace referencia el ID de clase determinado.

update

Actualiza la clase de entrada para evento a la que hace referencia el ID de clase dado.