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)
  },
  "appLinkData": {
    object (AppLinkData)
  }
}
Campos
kind
(deprecated)

string

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

eventName

object (LocalizedString)

Obligatorio. El nombre del evento, por ejemplo, "LA Dodgers de los Gigantes de San Francisco".

eventId

string

Es el ID del evento. Este ID debe ser único para cada evento en una cuenta. Se usa para agrupar entradas si el usuario guardó varias entradas 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 proporciona, la plataforma intentará usar otros datos para agrupar los tickets (posiblemente inestables).

venue

object (EventVenue)

Detalles del lugar para eventos.

dateTime

object (EventDateTime)

La fecha & la 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, de modo que las traducciones se muestran al usuario en función de su configuración regional.

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

customConfirmationCodeLabel

object (LocalizedString)

Una etiqueta personalizada para usar en el valor del código de confirmación (eventTicketObject.reservationInfo.confirmationCode) en la vista de detalles de la tarjeta. Solo debe usarse si se muestra el valor predeterminado "Confirmation Code" o una de las opciones de confirmationCodeLabel no es suficiente.

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

seatLabel

enum (SeatLabel)

Es la etiqueta que se usará para el valor de licencia (eventTicketObject.seatInfo.seat) 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 hayan configurado seatLabel ni customSeatLabel. Si no se establece ninguno, la etiqueta predeterminada será "Asiento" (localizada). Si no se establece el campo de asiento, no se usará esta etiqueta.

customSeatLabel

object (LocalizedString)

Una etiqueta personalizada para usar en el valor de licencias (eventTicketObject.seatInfo.seat) en la vista de detalles de la tarjeta. Solo se debe usar si la opción predeterminada "Asiento" o una de las opciones de seatLabel no es suficiente.

Es posible que no se hayan configurado seatLabel ni customSeatLabel. Si no se establece ninguno, la etiqueta predeterminada será "Asiento" (localizada). 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 hayan configurado 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.

customRowLabel

object (LocalizedString)

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

Es posible que no se hayan configurado 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, de modo que las traducciones se muestran al usuario en función de su configuración regional.

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

customSectionLabel

object (LocalizedString)

Una etiqueta personalizada para usar en el valor de la sección (eventTicketObject.seatInfo.section) en la vista de detalles de la tarjeta. Esto solo debe usarse si la configuración predeterminada de "Sección" o una de las opciones de sectionLabel no es suficiente.

Es posible que no se hayan configurado sectionLabel ni customSectionLabel. Si no se establece ninguno, la etiqueta se establecerá de forma predeterminada en "Sección", localizada. Si no estableces 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, de modo que las traducciones se muestran al usuario en función de su configuración regional.

Es posible que no se hayan configurado 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)

Una etiqueta personalizada para usar en el valor de la puerta (eventTicketObject.seatInfo.gate) en la vista de detalles de la tarjeta. Solo debe usarse si la opción predeterminada "Puerta" o una de las opciones de gateLabel no es suficiente.

Es posible que no se hayan configurado 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 plantilla sobre cómo se debe mostrar la clase. Si no la estableces, Google recurrirá a un conjunto predeterminado de campos para mostrar.

id

string

Obligatorio. Es el identificador único de una clase. Este ID debe ser único en todas las clases de una entidad emisora. 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 “-”.

version
(deprecated)

string (int64 format)

Obsoleto

issuerName

string

Obligatorio. 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)

Un array 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.

allowMultipleUsersPerObject
(deprecated)

boolean

Obsoleta. Usa multipleDevicesAndHoldersAllowedStatus en su lugar.

homepageUri

object (Uri)

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[]

object (LatLongPoint)

Nota: Por el momento, este campo no se admite 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 cambie el estado de revisión de draft, no se puede 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 configurar este campo como underReview cuando creas que la clase está lista para usarse. La plataforma establecerá automáticamente este campo en approved y se puede usar de inmediato para crear o migrar objetos.

Cuando actualices una clase que ya es approved, debes seguir estableciendo este campo en 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 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 10 para el objeto y 10 para la clase.

redemptionIssuers[]

string (int64 format)

Identifica qué entidades emisoras de canje pueden canjear el pase con Smart Tap. Las entidades emisoras de canje se identifican con su ID de entidad emisora. Las entidades emisoras de canjes deben tener configurada al menos una clave de Toque inteligente.

Los campos enableSmartTap y smartTapRedemptionLevel de nivel de 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)

Imagen del banner opcional que se muestra en el frente de la tarjeta. Si no hay ninguno, no se mostrará nada. La imagen se mostrará con un ancho del 100%.

wordMark
(deprecated)

object (Image)

Obsoleta.

enableSmartTap

boolean

Identifica si esta clase es compatible con el Toque inteligente. Los campos redemptionIssuers y smartTapRedemptionLevel de nivel de objeto también deben configurarse correctamente para que un pase admita el Toque inteligente.

hexBackgroundColor

string

El color de fondo de la tarjeta Si no se establece el color dominante de la imagen principal, 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 encryptionName. La longitud máxima recomendada es de 20 caracteres para garantizar que la cadena completa se muestre en las 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 configura, se renderizará una animación de seguridad en los detalles del pase.

viewUnlockRequirement

enum (ViewUnlockRequirement)

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

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)

Es 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

La fecha y hora en que se abrirán las puertas del lugar.

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 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ían 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 estaría 20 minutos y 50.52 segundos después de la hora 19 del 12 de abril de 1985, 4 horas antes de UTC (mismo tiempo que el ejemplo anterior). Si el evento fuera en Nueva York, sería el equivalente a la hora de verano del este (EDT). Recuerde que la compensación varía en las regiones que respetan 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 local del lugar. Por ejemplo, si el evento se lleva a cabo a las 20 horas 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 local en el lugar es 4 horas antes de UTC, se puede agregar una compensación de -04:00.

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

start

string

Fecha y hora en la que comienza el evento. Si el evento dura 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 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ían 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 estaría 20 minutos y 50.52 segundos después de la hora 19 del 12 de abril de 1985, 4 horas antes de UTC (mismo tiempo que el ejemplo anterior). Si el evento fuera en Nueva York, sería el equivalente a la hora de verano del este (EDT). Recuerde que la compensación varía en las regiones que respetan 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 local del lugar. Por ejemplo, si el evento se lleva a cabo a las 20 horas 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 local en el lugar es 4 horas antes de UTC, se puede agregar una compensación de -04:00.

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

end

string

Fecha y hora de finalización del evento. Si el evento dura varios días, debe ser la fecha y hora de finalización del último 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 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ían 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 estaría 20 minutos y 50.52 segundos después de la hora 19 del 12 de abril de 1985, 4 horas antes de UTC (mismo tiempo que el ejemplo anterior). Si el evento fuera en Nueva York, sería el equivalente a la hora de verano del este (EDT). Recuerde que la compensación varía en las regiones que respetan 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 local del lugar. Por ejemplo, si el evento se lleva a cabo a las 20 horas 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 local en el lugar es 4 horas antes de UTC, se puede agregar una compensación de -04:00.

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

doorsOpenLabel

enum (DoorsOpenLabel)

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, de modo que las traducciones se muestran al usuario en función de su configuración regional.

Es posible que no se hayan configurado 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 configuración predeterminada "Puertas abiertas" o una de las opciones de doorsOpenLabel no es suficiente.

Es posible que no se hayan configurado 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

Alias heredado de CONFIRMATION_CODE. Obsoleta.

CONFIRMATION_NUMBER
confirmationNumber

Alias heredado de CONFIRMATION_NUMBER. Obsoleta.

ORDER_NUMBER
orderNumber

Alias heredado de ORDER_NUMBER. Obsoleta.

RESERVATION_NUMBER
reservationNumber

Alias heredado de RESERVATION_NUMBER. Obsoleta.

SeatLabel

Enumeraciones
SEAT_LABEL_UNSPECIFIED
SEAT
seat

Alias heredado de SEAT. Obsoleta.

RowLabel

Enumeraciones
ROW_LABEL_UNSPECIFIED
ROW
row

Alias heredado de ROW. Obsoleta.

SectionLabel

Enumeraciones
SECTION_LABEL_UNSPECIFIED
SECTION
section

Alias heredado de SECTION. Obsoleta.

THEATER
theater

Alias heredado de THEATER. Obsoleta.

GateLabel

Enumeraciones
GATE_LABEL_UNSPECIFIED
GATE
gate

Alias heredado de GATE. Obsoleta.

DOOR
door

Alias heredado de DOOR. Obsoleta.

ENTRANCE
entrance

Alias heredado de ENTRANCE. Obsoleta.

Métodos

addmessage

Agrega un mensaje a la clase de entrada para el evento a la que hace referencia el ID de clase especificado.

get

Devuelve la clase de entrada para evento con el ID de clase especificado.

insert

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

list

Devuelve una lista de todas las clases de entradas para eventos de un ID de entidad emisora determinado.

patch

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

update

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