REST Resource: eventticketobject

Recurso: EventTicketObject

Representação 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 o tipo de recurso. Valor: a string fixa "walletobjects#eventTicketObject".

classReference

object (EventTicketClass)

Uma cópia dos campos herdados da classe pai. Estes campos são recuperados durante um GET.

seatInfo

object (EventSeat)

Detalhes de assento deste ingresso.

reservationInfo

object (EventReservationInfo)

Detalhes da reserva deste ingresso. Espera-se que sejam os mesmos para todos os ingressos que foram comprados no mesmo pedido.

ticketHolderName

string

Nome do titular do ingresso, caso ele esteja atribuído a alguém. Por exemplo, "João da Silva" ou "Maria da Silva".

ticketNumber

string

O número da passagem. Pode ser um identificador exclusivo entre todos os ingressos no sistema de um emissor, todos os ingressos para o evento (por exemplo, XYZ1234512345) ou todos os ingressos do pedido (1, 2, 3 etc.).

ticketType

object (LocalizedString)

O tipo de ingresso, como "Adulto", "Criança", "VIP" ou "Padrão".

faceValue

object (Money)

O valor nominal do ingresso, correspondendo ao que seria impresso em uma versão física do ingresso.

groupingInfo

object (GroupingInfo)

Informações que controlam como os cartões são agrupados.

linkedOfferIds[]

string

Uma lista de objetos de oferta vinculados a este ingresso de evento. Os objetos de oferta já devem existir.

Os IDs de objeto da oferta precisam seguir o formato issuer ID.identifier, em que o primeiro é emitido pelo Google e o segundo é escolhido por você.

hexBackgroundColor

string

A cor de fundo do card. Se não estiver definida, será usada a cor dominante da imagem principal e, se nenhuma imagem principal estiver definida, a cor predominante do logotipo será usada. O formato é #rrggbb, em que rrggbb é um trio RGB hexadecimal, como #ffcc00. Também é possível usar a versão abreviada do trio RGB, que é #rgb, como #fc0.

id

string

Obrigatório. O identificador exclusivo de um objeto. Esse ID precisa ser exclusivo entre todos os objetos de um emissor. Esse valor precisa seguir o formato issuer ID.identifier, em que o primeiro é emitido pelo Google e o segundo é escolhido por você. O identificador exclusivo deve incluir apenas caracteres alfanuméricos, ".", "_" ou "-".

classId

string

Obrigatório. A classe associada a este objeto. A classe precisa ser do mesmo tipo que este objeto, já deve existir e ser aprovada.

Os IDs de classe precisam seguir o formato issuer ID.identifier, em que o primeiro é emitido pelo Google e o segundo é escolhido por você.

version
(deprecated)

string (int64 format)

Suspenso

state

enum (State)

Obrigatório. O estado do objeto. Este campo é usado para determinar como um objeto é exibido no app. Por exemplo, um objeto inactive é movido para a seção "Cartões expirados".

barcode

object (Barcode)

O tipo e o valor do código de barras.

messages[]

object (Message)

Um conjunto de mensagens exibidas no app. Todos os usuários deste objeto receberão as mensagens associadas. O número máximo destes campos é 10.

validTimeInterval

object (TimeInterval)

O período em que esse objeto fica active e pode ser usado. O estado de um objeto será alterado para expired quando esse período se esgotar.

locations[]
(deprecated)

object (LatLongPoint)

Observação: no momento, esse campo não é compatível com o acionamento de notificações geográficas.

hasUsers

boolean

Indica se o objeto tem usuários. Este campo é definido pela plataforma.

smartTapRedemptionValue

string

O valor que será transmitido para um terminal certificado pelo Toque inteligente por NFC para este objeto. Os campos de nível de classe enableSmartTap e redemptionIssuers também precisam ser configurados corretamente para que o cartão ofereça suporte ao Toque inteligente. Somente caracteres ASCII são aceitos.

hasLinkedDevice

boolean

Indica se este objeto está vinculado a um único dispositivo no momento. Este campo é definido pela plataforma quando um usuário salva o objeto, vinculando-o ao dispositivo. Destinado ao uso por parceiros selecionados. Entre em contato com o suporte para mais informações.

disableExpirationNotification

boolean

Indica se as notificações devem ser explicitamente suprimidas. Se esse campo estiver definido como verdadeiro, independentemente do campo messages, as notificações de expiração enviadas para o usuário serão suprimidas. Por padrão, esse campo é definido como falso.

Atualmente, só é possível definir isso para ofertas.

infoModuleData

object (InfoModuleData)

Obsoleto. Use textModulesData.

imageModulesData[]

object (ImageModuleData)

Dados do módulo de imagem. O número máximo de campos exibidos é 1 no nível do objeto e 1 no nível do objeto da classe.

textModulesData[]

object (TextModuleData)

Dados do módulo de texto. Se os dados do módulo de texto também estiverem definidos na classe, ambos serão exibidos. O número máximo de campos exibidos é 10 para o objeto e 10 para a classe.

rotatingBarcode

object (RotatingBarcode)

O tipo e o valor do código de barras rotativo.

heroImage

object (Image)

Imagem do banner opcional exibida na parte frontal do cartão. Se não houver nenhuma, a imagem principal da classe, se houver, será exibida. Se a imagem principal da classe também não estiver presente, nada será exibido.

passConstraints

object (PassConstraints)

Transmitir restrições para o objeto. Inclui limitar os comportamentos de NFC e captura de tela.

saveRestrictions

object (SaveRestrictions)

Restrições ao objeto que precisam ser verificadas antes que o usuário tente salvar o cartão. Essas restrições só serão aplicadas durante o tempo de gravação. Se as restrições mudarem depois que um usuário salvar o cartão, as novas restrições não serão aplicadas a um cartão já salvo.

linkedObjectIds[]

string

linkedObjectIds é uma lista de outros objetos, como ingresso de evento, fidelidade, oferta, genérico, vale-presente, cartão de transporte público e cartão de embarque, que precisa ser anexada automaticamente a esse objeto de ingresso de evento. Se um usuário tivesse salvo esse ingresso para evento, esses linkedObjectIds seriam enviados automaticamente para a carteira do usuário, a menos que ele tenha desativado a configuração para receber esses cartões vinculados.

Verifique se os objetos presentes em linkedObjectIds já foram inseridos. Caso contrário, as chamadas vão falhar. Depois de vincular, não é possível desvincular os objetos. Não é possível vincular objetos que pertencem a outro emissor. Há um limite para o número de objetos que podem ser vinculados a um único objeto. Depois que o limite for alcançado, os novos objetos vinculados na chamada serão ignorados silenciosamente.

Os IDs de objeto precisam seguir o formato issuer ID.identifier, em que o primeiro é emitido pelo Google e o segundo é escolhido por você.

notifyPreference

enum (NotificationSettingsForUpdates)

Se as atualizações de campo para esse objeto devem ou não acionar notificações. Quando definida como NOTIFY, tentaremos acionar uma notificação de atualização de campo para os usuários. Essas notificações só serão enviadas aos usuários se o campo fizer parte de uma lista de permissões. Se definido como DO_NOT_NOTIFY ou NOTIFICATION_SETTINGS_UNSPECIFIED, nenhuma notificação será acionada. Essa configuração é temporária e precisa ser definida com cada solicitação PATCH ou UPDATE. Caso contrário, uma notificação não será acionada.

valueAddedModuleData[]

object (ValueAddedModuleData)

Dados opcionais do módulo de valor agregado. Máximo de 10 no objeto.

EventSeat

Representação JSON
{
  "kind": string,
  "seat": {
    object (LocalizedString)
  },
  "row": {
    object (LocalizedString)
  },
  "section": {
    object (LocalizedString)
  },
  "gate": {
    object (LocalizedString)
  }
}
Campos
kind
(deprecated)

string

Identifica o tipo de recurso. Valor: a string fixa "walletobjects#eventSeat".

seat

object (LocalizedString)

O número do assento, como "1", "2", "3" ou qualquer outro identificador de assento.

Este campo é localizável, portanto, é possível traduzir palavras ou usar alfabetos diferentes para os caracteres em um identificador.

row

object (LocalizedString)

A fileira do assento, como "1", E", "BB" ou "A5".

Este campo é localizável, portanto, é possível traduzir palavras ou usar alfabetos diferentes para os caracteres em um identificador.

section

object (LocalizedString)

A seção do assento, como "121".

Este campo pode ser localizado para que você possa traduzir palavras ou usar diferentes alfabetos para os caracteres em um identificador.

gate

object (LocalizedString)

O portão em que o titular do ingresso deve entrar para chegar ao devido assento, como "A" ou "Oeste".

Este campo pode ser localizado para que você possa traduzir palavras ou usar diferentes alfabetos para os caracteres em um identificador.

EventReservationInfo

Representação JSON
{
  "kind": string,
  "confirmationCode": string
}
Campos
kind
(deprecated)

string

Identifica o tipo de recurso. Valor: a string fixa "walletobjects#eventReservationInfo".

confirmationCode

string

O código de confirmação da reserva do evento. Também pode assumir a forma de um "número do pedido", "número de confirmação", "número da reserva" ou outro equivalente.

Métodos

addmessage

Adiciona uma mensagem ao objeto de ingresso de evento indicado pelo ID de objeto fornecido.

get

Retorna o objeto de ingresso de evento com o ID de objeto fornecido.

insert

Insere um objeto de ingresso de evento com o ID e as propriedades especificados.

list

Retorna uma lista de todos os objetos de ingresso de evento para um determinado ID de emissor.

modifylinkedofferobjects

Modifica objetos de oferta vinculados do objeto de ingresso de evento com o código fornecido.

patch

Atualiza o objeto de ingresso de evento indicado pelo ID de objeto fornecido.

update

Atualiza o objeto de ingresso de evento indicado pelo ID de objeto fornecido.