REST Resource: eventticketclass

Recurso: EventTicketClass

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

eventName

object (LocalizedString)

Obrigatório. O nome do evento, como "LA Dodgers x SF Giants".

eventId

string

O ID do evento. Esse ID precisa ser exclusivo para todos os eventos em uma conta. É usado para agrupar ingressos, caso o usuário tenha salvo vários ingressos para o mesmo evento. Pode ter no máximo 64 caracteres.

Se fornecido, o agrupamento será estável. Tenha cuidado com colisões não intencionais para evitar agrupar ingressos que não devem ser agrupados. Se você usar apenas uma classe por evento, basta defini-la com o classId (com ou sem a parte do ID do emissor).

Se não for fornecido, a plataforma tentará usar outros dados para agrupar ingressos (potencialmente instável).

venue

object (EventVenue)

Detalhes do local do evento.

dateTime

object (EventDateTime)

As informações de data e hora do evento.

confirmationCodeLabel

enum (ConfirmationCodeLabel)

O rótulo para usar como valor do código de confirmação (eventTicketObject.reservationInfo.confirmationCode) na visualização de detalhes do cartão. Cada opção disponível é mapeada para um conjunto de strings localizadas, para que as traduções sejam mostradas ao usuário com base na localidade dele.

Não é possível definir os dois (confirmationCodeLabel e customConfirmationCodeLabel), apenas um deles. Se nenhum deles for definido, o rótulo será padronizado como "Código de confirmação", localizado. Se o campo do código de confirmação não estiver definido, este rótulo não será usado.

customConfirmationCodeLabel

object (LocalizedString)

Um rótulo personalizado para usar como valor do código de confirmação (eventTicketObject.reservationInfo.confirmationCode) na visualização de detalhes do cartão. Só deverá ser usado se o rótulo "Código de confirmação" padrão ou uma das opções de confirmationCodeLabel não for suficiente.

Não é possível definir os dois (confirmationCodeLabel e customConfirmationCodeLabel), apenas um deles. Se nenhum deles estiver definido, o rótulo padrão será "Código de confirmação", localizado. Se o campo do código de confirmação não estiver definido, este rótulo não será usado.

seatLabel

enum (SeatLabel)

O rótulo para usar como valor do assento (eventTicketObject.seatInfo.seat) na visualização de detalhes do cartão. Cada opção disponível é mapeada para um conjunto de strings localizadas, para que as traduções sejam mostradas ao usuário com base na localidade dele.

Não é possível definir seatLabel e customSeatLabel. Se nenhum deles estiver definido, o rótulo padrão será "Assento", localizado. Se o campo do assento não estiver definido, este rótulo não será usado.

customSeatLabel

object (LocalizedString)

Um rótulo personalizado para usar como valor do assento (eventTicketObject.seatInfo.seat) na visualização de detalhes do cartão. Só será usado se o rótulo "Assento" padrão ou uma das opções de seatLabel não for suficiente.

Não é possível definir os dois (seatLabel e customSeatLabel), apenas um deles. Se nenhum deles estiver definido, o rótulo padrão será "Assento", localizado. Se o campo do assento não estiver definido, este rótulo não será usado.

rowLabel

enum (RowLabel)

O rótulo para usar como valor da fileira (eventTicketObject.seatInfo.row) na visualização de detalhes do cartão. Cada opção disponível é mapeada para um conjunto de strings localizadas, para que as traduções sejam mostradas ao usuário com base na localidade dele.

Não é possível definir os dois (rowLabel e customRowLabel), apenas um deles. Se nenhum deles estiver definido, o rótulo padrão será "Fileira", localizado. Se o campo da fileira não estiver definido, este rótulo não será usado.

customRowLabel

object (LocalizedString)

Um rótulo personalizado para usar como valor da linha (eventTicketObject.seatInfo.row) na visualização de detalhes do cartão. Só será usado se o rótulo "Linha" padrão ou uma das opções de rowLabel não for suficiente.

Não é possível definir rowLabel e customRowLabel. Se nenhum deles estiver definido, o rótulo padrão será "Fileira", localizado. Se o campo da fileira não estiver definido, este rótulo não será usado.

sectionLabel

enum (SectionLabel)

O rótulo a ser usado como valor da seção (eventTicketObject.seatInfo.section) na visualização de detalhes do cartão. Cada opção disponível é mapeada para um conjunto de strings localizadas, para que as traduções sejam mostradas ao usuário com base na localidade dele.

Não é possível definir sectionLabel e customSectionLabel. Se nenhum deles for definido, o rótulo padrão será "Seção", localizado. Se o campo da seção não estiver definido, este rótulo não será usado.

customSectionLabel

object (LocalizedString)

Um rótulo personalizado para usar como valor da seção (eventTicketObject.seatInfo.section) na visualização de detalhes do cartão. Só será usado se o rótulo "Seção" padrão ou uma das opções de sectionLabel não for suficiente.

Não é possível definir sectionLabel e customSectionLabel. Se nenhum deles for definido, o rótulo padrão será "Seção", localizado. Se o campo da seção não estiver definido, este rótulo não será usado.

gateLabel

enum (GateLabel)

O rótulo para usar como valor do portão (eventTicketObject.seatInfo.gate) na visualização de detalhes do cartão. Cada opção disponível é mapeada para um conjunto de strings localizadas, para que as traduções sejam mostradas ao usuário com base na localidade dele.

Não é possível definir os dois (gateLabel e customGateLabel), apenas um deles. Se nenhum deles for definido, o rótulo padrão será "Portão", localizado. Se o campo do portão não estiver definido, este rótulo não será usado.

customGateLabel

object (LocalizedString)

Um rótulo personalizado para usar como valor do portão (eventTicketObject.seatInfo.gate) na visualização de detalhes do cartão. Só será usado se o rótulo "Portão" padrão ou uma das opções de gateLabel não for suficiente.

Não é possível definir os dois (gateLabel e customGateLabel), apenas um deles. Se nenhum deles for definido, o rótulo padrão será "Portão", localizado. Se o campo do portão não estiver definido, este rótulo não será usado.

finePrint

object (LocalizedString)

Detalhes, termos ou condições do ingresso.

classTemplateInfo

object (ClassTemplateInfo)

Informações de modelo sobre como a classe deve ser exibida. Se não estiver definido, o Google vai usar um conjunto padrão de campos a serem exibidos.

id

string

Obrigatório. O identificador exclusivo de uma classe. Esse ID precisa ser exclusivo entre todas as classes 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 '-'.

version
(deprecated)

string (int64 format)

Suspenso

issuerName

string

Obrigatório. O nome do emissor. O comprimento máximo recomendado é 20 caracteres, para garantir que a string inteira seja exibida em telas menores.

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 desses campos é 10.

allowMultipleUsersPerObject
(deprecated)

boolean

Obsoleto. Use multipleDevicesAndHoldersAllowedStatus

homepageUri

object (Uri)

O URI da página inicial do seu aplicativo. Preencher o URI neste campo resulta no mesmo comportamento que o preenchimento de um URI em linksModuleData: quando um objeto é renderizado, um link para a página inicial é mostrado no que normalmente seria considerado a seção linksModuleData do objeto.

locations[]
(deprecated)

object (LatLongPoint)

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

reviewStatus

enum (ReviewStatus)

Obrigatório. O status da classe. Este campo pode ser definido como draft ou underReview usando as chamadas de inserção, correção ou atualização de API. Depois que o estado da revisão for alterado de draft, ele não será alterado novamente para draft.

Mantenha este campo como draft quando a classe estiver em desenvolvimento. Não é possível usar uma classe draft para criar nenhum objeto.

Defina este campo como underReview quando acreditar que a classe está pronta para uso. A plataforma definirá automaticamente esse campo como approved, e ele poderá ser usado imediatamente para criar ou migrar objetos.

Ao atualizar uma classe já approved, continue definindo este campo como underReview.

review

object (Review)

Os comentários de revisão definidos pela plataforma quando uma classe é marcada como approved ou rejected.

infoModuleData
(deprecated)

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.

redemptionIssuers[]

string (int64 format)

Identifica quais emissores de resgate podem resgatar o cartão pelo Toque inteligente. Os emissores de resgate são identificados pelo ID do emissor. Os emissores de resgate precisam ter pelo menos uma chave do Toque inteligente configurada.

Os campos enableSmartTap e smartTapRedemptionLevel no nível do objeto também precisam ser configurados corretamente para que o cartão ofereça suporte ao Toque inteligente.

countryCode

string

Código do país usado para mostrar o país do cartão (quando o usuário não está nesse país), bem como para mostrar o conteúdo localizado quando o conteúdo não está disponível na localidade do usuário

heroImage

object (Image)

Imagem de banner opcional exibida na frente do cartão. Se não houver nenhuma, nada será exibido. A imagem será exibida com 100% de largura.

wordMark
(deprecated)

object (Image)

Obsoleto.

enableSmartTap

boolean

Identifica se essa classe oferece suporte ao Toque inteligente. Os campos redemptionIssuers e smartTapRedemptionLevel no nível do objeto também precisam ser configurados corretamente para que o cartão ofereça suporte ao Toque inteligente.

hexBackgroundColor

string

A cor de fundo do card. Se não estiver definida, a cor predominante da imagem principal será usada. Se não houver nenhuma imagem principal definida, a cor predominante do logotipo será usada. O formato é #rrggbb, em que rrggbb é um trio RGB hexadecimal, como #ffcc00. Você também pode usar a versão abreviada do trio RGB, que é o número rgb, como #fc0.

localizedIssuerName

object (LocalizedString)

Strings traduzidas do emissorName. O tamanho máximo recomendado é 20 caracteres, para garantir que a string inteira seja exibida em telas menores.

multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

Identifica se vários usuários e dispositivos vão salvar o mesmo objeto que faz referência a esta classe.

callbackOptions

object (CallbackOptions)

Opções de callback a serem usadas para retornar ao emissor em cada salvamento/exclusão de um objeto desta classe pelo usuário final. Todos os objetos desta classe são qualificados para callback.

securityAnimation

object (SecurityAnimation)

Informações opcionais sobre a animação de segurança. Se estiver definido, uma animação de segurança será renderizada nos detalhes do cartão.

viewUnlockRequirement

enum (ViewUnlockRequirement)

Confira as opções de requisito de desbloqueio para o ingresso do evento.

notifyPreference

enum (NotificationSettingsForUpdates)

Se as atualizações de campo para essa classe precisam acionar notificações. Quando definido como NOTIFY, tentamos 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 não for especificado, 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. No máximo dez na turma. Para um cartão, apenas dez serão exibidos, priorizando os do objeto.

EventVenue

Representação JSON
{
  "kind": string,
  "name": {
    object (LocalizedString)
  },
  "address": {
    object (LocalizedString)
  }
}
Campos
kind
(deprecated)

string

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

name

object (LocalizedString)

O nome do lugar, como "AT&T Park".

Obrigatório.

address

object (LocalizedString)

O endereço do lugar, como "24 Willie Mays Plaza\nSan Francisco, CA 94107". As linhas de endereço são separadas por caracteres de avanço de linha (\n).

Obrigatório.

EventDateTime

Representação JSON
{
  "kind": string,
  "doorsOpen": string,
  "start": string,
  "end": string,
  "doorsOpenLabel": enum (DoorsOpenLabel),
  "customDoorsOpenLabel": {
    object (LocalizedString)
  }
}
Campos
kind
(deprecated)

string

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

doorsOpen

string

A data/hora em que as portas do local serão abertas.

É uma data/hora em formato estendido ISO 8601, com ou sem compensação. O horário pode ser especificado com precisão de nanossegundos. As compensações podem ser especificadas com precisão de segundos, mesmo que os segundos de compensação não façam parte do padrão ISO 8601.

Exemplo:

1985-04-12T23:20:50.52Z seria 20 minutos e 50,52 segundos após as 23h de 12 de abril de 1985 no UTC.

1985-04-12T19:20:50.52-04:00 seria 20 minutos e 50,52 segundos após a 19ª hora de 12 de abril de 1985, 4 horas antes do UTC (no mesmo instante que o do exemplo acima). Se o evento fosse em Nova York, seria o equivalente ao horário de verão do leste dos EUA (EDT, na sigla em inglês). Lembre-se de que a compensação varia em regiões que seguem o horário de verão, dependendo da época do ano.

1985-04-12T19:20:50.52 seria 20 minutos e 50,52 segundos após a 19a hora de 12 de abril de 1985, sem informações de compensação.

A parte da data/hora sem a compensação é considerada "data/hora local". Deve ser a data/hora local no lugar. Por exemplo, se o evento ocorrer na 20a hora de 5 de junho de 2018 no local, a parte de data/hora local precisa ser 2018-06-05T20:00:00. Se a data/hora local no lugar for 4 horas antes do UTC, poderá ser acrescentada uma compensação de -04:00.

Sem informações de compensação, talvez alguns recursos avançados não fiquem disponíveis.

start

string

A data/hora em que o evento começa. Se o evento se estender por vários dias, deverá ser a data/hora de início no primeiro dia.

É uma data/hora em formato estendido ISO 8601, com ou sem compensação. O horário pode ser especificado com precisão de nanossegundos. As compensações podem ser especificadas com precisão de segundos, mesmo que os segundos de compensação não façam parte do padrão ISO 8601.

Exemplo:

1985-04-12T23:20:50.52Z seria 20 minutos e 50,52 segundos após as 23h de 12 de abril de 1985 no UTC.

1985-04-12T19:20:50.52-04:00 seria 20 minutos e 50,52 segundos após a 19ª hora de 12 de abril de 1985, 4 horas antes do UTC (no mesmo instante que o do exemplo acima). Se o evento fosse em Nova York, seria o equivalente ao horário de verão do leste dos EUA (EDT, na sigla em inglês). Lembre-se de que a compensação varia em regiões que seguem o horário de verão, dependendo da época do ano.

1985-04-12T19:20:50.52 seria 20 minutos e 50,52 segundos após a 19a hora de 12 de abril de 1985, sem informações de compensação.

A parte da data/hora sem a compensação é considerada "data/hora local". Deve ser a data/hora local no lugar. Por exemplo, se o evento ocorrer na 20a hora de 5 de junho de 2018 no local, a parte de data/hora local precisa ser 2018-06-05T20:00:00. Se a data/hora local no lugar for 4 horas antes do UTC, poderá ser acrescentada uma compensação de -04:00.

Sem informações de compensação, talvez alguns recursos avançados não fiquem disponíveis.

end

string

A data/hora em que o evento termina. Se o evento se estender por vários dias, deverá ser a data/hora de término no último dia.

É uma data/hora em formato estendido ISO 8601, com ou sem compensação. O horário pode ser especificado com precisão de nanossegundos. Os deslocamentos podem ser especificados com precisão de segundos, mesmo que os segundos de deslocamento não façam parte da norma ISO 8601.

Exemplo:

1985-04-12T23:20:50.52Z seria 20 minutos e 50,52 segundos após as 23h de 12 de abril de 1985 no UTC.

1985-04-12T19:20:50.52-04:00 seria 20 minutos e 50,52 segundos após a 19ª hora de 12 de abril de 1985, 4 horas antes do UTC (no mesmo instante que o do exemplo acima). Se o evento fosse em Nova York, seria o equivalente ao horário de verão do leste dos EUA (EDT, na sigla em inglês). Lembre-se de que a compensação varia em regiões que seguem o horário de verão, dependendo da época do ano.

1985-04-12T19:20:50.52 seria 20 minutos e 50,52 segundos após a 19a hora de 12 de abril de 1985, sem informações de compensação.

A parte da data/hora sem a compensação é considerada "data/hora local". Deve ser a data/hora local no lugar. Por exemplo, se o evento ocorrer na 20a hora de 5 de junho de 2018 no local, a parte de data/hora local precisa ser 2018-06-05T20:00:00. Se a data/hora local no lugar for 4 horas antes do UTC, poderá ser acrescentada uma compensação de -04:00.

Sem informações de compensação, talvez alguns recursos avançados não fiquem disponíveis.

doorsOpenLabel

enum (DoorsOpenLabel)

O rótulo para usar como valor de abertura (doorsOpen) na visualização de detalhes do cartão. Cada opção disponível é mapeada para um conjunto de strings localizadas, para que as traduções sejam mostradas ao usuário com base na localidade dele.

Não é possível definir os dois (doorsOpenLabel e customDoorsOpenLabel), apenas um deles. Se nenhum deles for definido, o rótulo padrão será "Abertura de portas", localizado. Se o campo de abertura não estiver definido, este rótulo não será usado.

customDoorsOpenLabel

object (LocalizedString)

Um rótulo personalizado para usar como valor de abertura (doorsOpen) na visualização de detalhes do cartão. Só deverá ser usado se o rótulo "Abertura" padrão ou uma das opções de doorsOpenLabel não for suficiente.

Não é possível definir os dois (doorsOpenLabel e customDoorsOpenLabel), apenas um deles. Se nenhum deles for definido, o rótulo padrão será "Abertura de portas", localizado. Se o campo de abertura não estiver definido, este rótulo não será usado.

DoorsOpenLabel

Enums
DOORS_OPEN_LABEL_UNSPECIFIED
DOORS_OPEN
doorsOpen

Alias legado de DOORS_OPEN. Obsoleto.

GATES_OPEN
gatesOpen

Alias legado de GATES_OPEN. Obsoleto.

ConfirmationCodeLabel

Enums
CONFIRMATION_CODE_LABEL_UNSPECIFIED
CONFIRMATION_CODE
confirmationCode

Alias legado de CONFIRMATION_CODE. Obsoleto.

CONFIRMATION_NUMBER
confirmationNumber

Alias legado de CONFIRMATION_NUMBER. Obsoleto.

ORDER_NUMBER
orderNumber

Alias legado de ORDER_NUMBER. Obsoleto.

RESERVATION_NUMBER
reservationNumber

Alias legado de RESERVATION_NUMBER. Obsoleto.

SeatLabel

Enums
SEAT_LABEL_UNSPECIFIED
SEAT
seat

Alias legado de SEAT. Obsoleto.

RowLabel

Enums
ROW_LABEL_UNSPECIFIED
ROW
row

Alias legado de ROW. Obsoleto.

SectionLabel

Enums
SECTION_LABEL_UNSPECIFIED
SECTION
section

Alias legado de SECTION. Obsoleto.

THEATER
theater

Alias legado de THEATER. Obsoleto.

GateLabel

Enums
GATE_LABEL_UNSPECIFIED
GATE
gate

Alias legado de GATE. Obsoleto.

DOOR
door

Alias legado de DOOR. Obsoleto.

ENTRANCE
entrance

Alias legado de ENTRANCE. Obsoleto.

Métodos

addmessage

Adiciona uma mensagem à classe de ingresso de evento indicada pelo ID de classe fornecido.

get

Retorna a classe de ingresso de evento com o ID de classe fornecido.

insert

Insere uma classe de ingresso de evento com o código e as propriedades especificados.

list

Retorna uma lista de todas as classes de ingresso de evento para um determinado ID de emissor.

patch

Atualiza a classe de ingresso de evento indicada pelo ID de classe fornecido.

update

Atualiza a classe de ingresso de evento indicada pelo ID de classe fornecido.