Package google.maps.booking.v1alpha

string

URL do ponto de entrada para esse link de ação.

string

Tag BCP-47 que identifica o idioma em que o conteúdo desse URI está disponível.

string

Código do país de acordo com a norma ISO 3166-1 alfa-2. Deixe em branco para definir uma visibilidade irrestrita.

ActionPlatform

Plataforma em que essa ação deve ser realizada. Se este campo não estiver definido, ACTION_PLATFORM_WEB_APPLICATION será usado como substituto.

ActionLinkType

Tipo de ação predeterminada.

OrderOnlineMetadata

Metadados do link do pedido on-line. Suporte à ação com ActionLinkType de ACTION_LINK_TYPE_SHOP_ONLINE.

FoodOrderingMetadata

Metadados dos links para pedidos de comida. Oferece suporte ao tipo de ação: * ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY * ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT NÃO oferece suporte a ACTION_LINK_TYPE_ORDER_FOOD.

Text

Mensagem personalizada a ser exibida para o usuário ao fazer uma reserva pelo Reservar com o Google.

Timestamp

Início do horário disponível.

Duration

Duração do horário disponível

int64

Número total de vagas e vagas em aberto desse horário disponível. Exemplos:

• Aula de ioga com 10 vagas e 3 já reservadas: availability {spots_total: 10, spots_open: 7 ...}
• Sessão de massagem rápida que já está totalmente reservada: availability {spots_total: 1, spots_open: 0 ...}

Observação: se você enviar solicitações usando o formato de compactação de disponibilidade definido abaixo, esses dois campos serão inferidos.

• Uma recorrência envolve spots_total=1 e spots_open=1.
• Uma ScheduleException indica que spots_total=1 e spots_open=0.

int64

Número de vagas abertas.

string

Uma string opaca opcional para identificar esse horário disponível. Se definida, ela será incluída nas solicitações que reservam/atualizam/cancelam compromissos.

Resources

Recursos opcionais usados para diferenciar esse horário disponível de outros quando diferentes membros da equipe ou salas fazem parte do serviço.

Por exemplo, a mesma aula de ioga com dois professores:

availability { resources { staff_id: "1" staff_name: "Amy" }
               spots_total: 10 spots_open: 7 }
availability { resources { staff_id: "2" staff_name: "John" }
               spots_total: 5 spots_open: 2 }

string

Uma lista de códigos que fazem referência às opções de pagamento disponíveis para pagar pelo espaço. As opções de pagamento reais são definidas no nível do comerciante e também podem ser compartilhadas entre vários deles.

Esse campo modifica qualquer payment_option_ids especificado na mensagem de serviço. Da mesma forma, os payment_option_ids definidos aqui NÃO precisam estar presentes na mensagem de serviço, mas precisam ser adicionados no nível do comerciante.

Recurrence

As informações de recorrência da disponibilidade, representando mais de um horário de início. Uma recorrência deve conter compromissos por um dia útil.

ScheduleException

Horários em que esse serviço não pode ser agendado. Para limitar o número de mensagens de schedule_exception, considere unir exceções adjacentes.

Deposit

Depósito opcional para essa disponibilidade. Substitui o depósito de serviço, se ele tiver sido especificado.

NoShowFee

Taxa opcional de não comparecimento para essa disponibilidade. Substitui a taxa de não comparecimento do serviço, se ela tiver sido especificada.

RequireCreditCard

Indica se o usuário precisa informar um cartão de crédito para reservar esse horário. Se o valor não for definido, ele será herdado do nível de serviço, se estiver indicado lá. (Opcional)

string

Indica uma lista de tipos de ingresso compatíveis com esse espaço disponível. Se esse campo não for definido, todos os tipos de ingresso no serviço pai estarão disponíveis para o espaço. Os valores desse campo precisam ser definidos no serviço pai. Exemplos:

• Serviço com quatro tipos de ingresso: TicketType {ticket_type_id: "adult_1" short_description: "Adult weekdays"} TicketType {ticket_type_id: "adult_2" short_description: "Adult weekends"} TicketType {ticket_type_id: "youth_1" short_description: "Youth weekdays"} TicketType {ticket_type_id: "youth_2" short_description: "Youth weekends"}

Para representar o inventário durante dias úteis: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...} Para representar o inventário durante feriados: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}

• Serviço com três tipos de ingresso: TicketType {ticket_type_id: "adult" short_description: "Adult"} TicketType {ticket_type_id: "youth" short_description: "Youth"} TicketType {ticket_type_id: "senior" short_description: "Senior"}

Para indicar que todos os três tipos de ingresso estão disponíveis para esse período, use availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} ou `availability {...}' (não defina ticket_type_id nesse espaço).

(opcional)

DurationRequirement

O requisito para mostrar a duração e/ou o horário de término dos slots. Este campo será ignorado se o horário não estiver disponível. Não é usado na indústria de Coisas legais para fazer. (opcional)

SchedulingRuleOverrides

Regras de programação de disponibilidade. Se os campos forem preenchidos, eles substituirão as regras de programação correspondentes nas SchedulingRules no nível de serviço.

ConfirmationMode

O modo de confirmação que será usado ao agendar essa disponibilidade. As tentativas de criar agendamentos para horários com o modo CONFIRMATION_MODE_SYNCHRONOUS precisam ser confirmadas ou negadas imediatamente. As tentativas de criar reservas para disponibilidades com o modo de confirmação CONFIRMATION_MODE_ASYNCHRONOUS precisam ser negadas imediatamente ou criadas com o status PENDING.

Timestamp

O carimbo de data/hora inclusivo máximo (UTC) em que a disponibilidade se repete.

Duration

Define o tempo entre os horários disponíveis consecutivos.

Exemplo: uma disponibilidade com duração de 20 min, repeat_every igual a 30 min, start_time igual a 9h e repeat_until igual a 11h resultará em espaços com períodos de 9-9h20, 9h30-9h50, 10-10h20, 10h30-10h50, 11-11h20. (obrigatório)

TimeRange

Período da exceção. Os espaços descritos pela recorrência que se sobrepõem a esse período em que a empresa está fechada serão considerados indisponíveis.

Exemplo: se a recorrência especificar uma duração de 20 min com repeat_every igual a 30 min, start_time igual a 9h e repeat_until igual a 11h, uma ScheduleException com time_range de 9h45-11h ficará indisponível nos espaços 9h30-9h50, 10-10h20 e 10h30-10h50.

Como esse é o período em que a empresa está fechada, o espaço que começa às 11h não seria afetado.

int64

A última vez (em segundos) que este espaço pode ser reservado. Esse carimbo de data/hora precisa ser anterior ao start_sec do espaço. Se os usuários quiserem reservar após o horário de início, deverão usar o SchedulingRules.min_booking_before_end_time do nível de serviço. Se esse valor tiver sido definido, ele modificará o especificado no min_booking_buffer das SchedulingRules do serviço correspondente.

int64

A primeira vez (em segundos) que este espaço pode ser reservado. Esse carimbo de data/hora precisa ser anterior ao start_sec do espaço ou last_bookable_sec, se especificado.

int64

Se definido, indica a última vez (em segundos, desde a época do Unix) em que esse horário específico pode ser cancelado pelo Reservar com o Google. Esse campo substitui todas as regras de cancelamento do nível de serviço. (opcional)

string

Nome do recurso com o formato: partners/{partner_id}/feeds/{feed_name}.

GenericDeleteRecord

Registros a serem excluídos. São permitidos no máximo 1.000 registros em uma chamada de API.

string

Nome do recurso com o formato: partners/{partner_id}/feeds/{feed_name}.

GenericRecord

Registros a serem inseridos e/ou atualizados. São permitidos no máximo 1.000 registros em uma chamada de API.

string

Formato de partners/{partner_id}.

ExtendedServiceAvailability

Disponibilidade de serviço estendida usada para substituir os horários disponíveis atuais.

ExtendedServiceAvailability

As mensagens de disponibilidade de serviço estendida foram atualizadas e usadas para substituir os horários disponíveis atuais.

string

Nome do recurso da reserva: partners/{partner ID}/bookings/{booking ID}

string

ID do comerciante do espaço

string

ID do serviço do comerciante

Timestamp

Início do horário disponível

Duration

Duração do horário disponível

ClientInformation

Informações pessoais do cliente que está fazendo o agendamento

BookingStatus

Status da reserva

PaymentInformation

Informações sobre transações de pagamento relacionadas à reserva.

int64

Número de pessoas da reserva

Cause

Motivo da falha na reserva. (obrigatório)

CreditCardType

(obrigatório apenas se a causa for PAYMENT_ERROR_CARD_TYPE_REJECTED)

string

Esse campo é opcional e pode ser usado pelo parceiro para incluir informações adicionais a serem aplicadas na depuração. (opcional)

PaymentFailureInformation

Informações sobre falhas de pagamento.

ThreeDS1Parameters

Parâmetros usados por um agregador de RwG para iniciar um protocolo de autenticação 3DS1 com o usuário. Serão ignorados, a não ser que BookingFailure.cause esteja definido como PAYMENT_REQUIRES_3DS1.

string

O URL a partir do qual carregar um formulário para apresentar ao usuário para autenticação.

string

Solicitação de PaymentAuthentication A ser postado no formulário ACSUrl, se fornecido.

string

Identificador usado pelo provedor ACS. A ser postado no formulário ACSUrl, se fornecido.

string

Dados do comerciante. A ser postado no formulário ACSUrl, se fornecido.

RefundCondition

Nenhuma ou mais condições de reembolso aplicáveis à política.

Duration

Limite antes do horário de início que o cliente pode solicitar o reembolso de parte do custo especificado em refund_percent. Quando esse campo é definido como 0 (padrão), o serviço pode ser cancelado a qualquer momento.

uint32

Porcentagem que pode ser reembolsada, desde que a reserva seja cancelada pelo menos min_duration_before_start_time antes do horário de início do serviço, no intervalo de [0, 100]. Quando esse campo é definido como 0 (padrão), o serviço não é reembolsável. Já o valor 100 indica que a quantia integral pode ser reembolsada.

string

Nome do cliente

string

Sobrenome do cliente

PostalAddress

Endereço do cliente

string

Número de telefone do cliente

string

Endereço de e-mail do cliente

string

O nome do recurso pai do parceiro proprietário desse comerciante, no formato partners/{partner_id}.

string

O ID a ser usado para este comerciante.

Merchant

O comerciante a ser criado.

string

O nome do recurso pai do comerciante proprietário do serviço, no formato partners/{partner_id}/merchants/{merchant_id}.

string

O ID a ser usado para este serviço.

Service

O serviço a ser criado.

CreditCardType

Uma lista de cartões de crédito aceitos. Nenhum cartão de crédito será aceito se o campo estiver vazio.

string

Nome do recurso do comerciante a ser excluído, no formato partners/{partner_id}/merchants/{merchant_id}

string

Nome do recurso do serviço a ser excluído, no formato partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Price

Valor do depósito.

int64

Cancelamento mínimo antecipado do depósito.

PriceType

Define como o depósito é determinado a partir da disponibilidade.

Text

Recomendamos que os usuários paguem somente pelas formas de pagamento mencionadas abaixo.

Duration

Duração mínima.

Duration

Duração máxima.

string

Este é um campo obrigatório para especificar a qual comerciante as mensagens de disponibilidade abaixo pertencem.

string

Este é um campo obrigatório para especificar a qual serviço as mensagens de disponibilidade abaixo pertencem.

Timestamp

Se esse campo for definido, consideraremos as entidades de disponibilidade indicadas como um instantâneo completo de [start_time_restrict, end_time_restrict]. Ou seja, todas as disponibilidades existentes serão excluídas se a seguinte condição for verdadeira:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

Se uma mensagem de duração for definida, a condição será ainda mais restritiva:

  availability.duration == duration_restrict

Se uma mensagem resources_restrict for definida, a condição será ainda mais restritiva:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

Esses campos normalmente são usados para enviar uma atualização completa da disponibilidade em um determinado período.

Quando você define start_time_restrict, mas não end_time_restrict, todo o período desde o valor definido em start_time_restrict é considerado.

Timestamp

Quando você define end_time_restrict, mas não start_time_restrict, todo o período até o end_time_restrict é considerado.

Duration

Definir a duração restringe ainda mais o escopo da atualização à disponibilidade com período correspondente.

Resources

Definir resources_restrict restringe ainda mais o escopo da atualização a esse conjunto de recursos. Todos os campos de código dos recursos precisam corresponder.

Availability

A nova lista de disponibilidade.

int64

Itens adicionados recentemente por este feed. Os itens podem ser comerciantes, serviços ou horários disponíveis, dependendo do tipo de feed.

int64

Itens existentes, atualizados conforme necessário com base nas informações mais recentes do feed.

int64

Os itens não estão mais presentes no feed e foram removidos.

string

Nome do recurso do feed, no formato

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

State

O estado de processamento deste feed.

string

String legível que mostrará mais detalhes se o feed não for processado.

FeedStatistics

Estatísticas específicas deste feed.

FeeDetails

Detalhes das taxas cobradas do usuário sobre o total do item. O valor é repetido para diferentes tipos de taxas, como taxas de serviço, de entrega etc.

AdvanceOrderDetails

Detalhes sobre o suporte avançado a pedidos, também conhecido como pedido antecipado, em que o usuário pode fazer um pedido para atendimento de forma mais tarde.

Duration

Duração fixa. Por exemplo: 30 minutos.

DurationRange

Um intervalo de duração. Exemplos: * 30 a 45 minutos * Mais de 30 minutos * Menos de 50 minutos

bool

Verdadeiro se for possível usar pedidos antecipados, também conhecidos como pedidos antecipados. (obrigatório)

FeeType

Tipo de taxa. (obrigatório)

FeeAmount

O valor da taxa na moeda da unidade, uma porcentagem do valor do carrinho ou uma combinação dos dois. (obrigatório)

QuantitativeValue

A taxa corresponde a uma porcentagem do valor do carrinho. Oferece suporte a um intervalo (limitado e ilimitado) ou a uma porcentagem fixa. O valor deve estar entre 0 e 100. Exemplos: * Fixo 5,5% * No mínimo 5,5% * No máximo 5,5% * 4,5% a 5,5%

Money

Valor fixo. Por exemplo, US$ 3,5.

MoneyRange

Intervalo de valor. Exemplos: * US$ 3,5 a US$ 5,5 * No mínimo US$ 3,5 * No máximo US$ 5,5

bool

Valor desconhecido.

FulfillmentType

Obrigatório. O tipo de atendimento do pedido.

AvailableDay

Obrigatório. Uma lista de dias em que há disponibilidade deste método de atendimento do pedido (de preferência, pelo menos dois).

FeeDetails

Obrigatório. Detalhes da taxa do método de atendimento do pedido.

Price

Obrigatório. Pedido mínimo do método de fulfillment associado ao link de ação.

Date

Obrigatório. Uma data disponível para um método de atendimento de pedidos. Presumimos que esteja no fuso horário do comerciante.

Timestamp

Obrigatório. Carimbo de data/hora Unix. A última vez que um usuário fez um pedido e recebeu itens até fulfillment_date. Em outras palavras, depois de last_ordering_time, fulfillment_date não será mais exibido como disponível.

Por exemplo, se fulfillment_date é 2020-08-10: - o valor last_ordering_time 2020-08-10 18:00 significa que, para receber um pedido em 2020-08-10, o cliente precisa fazer o pedido até as 18h do mesmo dia. - Um valor de last_ordering_time 2020-08-08 20:00 significa que, para receber o pedido em 2020-08-10, o cliente precisa fazer o pedido até às 20h dois dias antes.

NoFee

Não há taxas para o método de atendimento do pedido.

MinimumFee

A taxa básica associada ao método de atendimento do pedido.

FixedFee

A taxa fixa associada ao método de atendimento do pedido.

Price

Obrigatório. O valor da taxa fixa para o método de atendimento do pedido.

Price

Obrigatório. O valor da taxa básica do método de atendimento do pedido.

Timestamp

Obrigatório. Esse carimbo de data/hora é usado para determinar a ordem em que uma exclusão será aplicada ao inventário.

bytes

Para feeds não baseados em protótipos.

Any

Para feeds baseados em protótipos.

Timestamp

Obrigatório. Esse carimbo de data/hora é usado para garantir a ordem correta das atualizações de inventário.

bytes

Para feeds não baseados em protótipos.

Any

Para feeds baseados em protótipos.

double

Latitude em graus. (opcional)

double

Longitude em graus. (opcional)

PostalAddress

Endereço postal do local, de preferência.

string

Um endereço não estruturado também pode ser usado. Por exemplo, "1600 amphitheatre parkway mountain view, ca 94043".

string

Obrigatório. Nome do recurso, no formato partners/{partner_id}/merchants/{merchant_id}/status.

string

Nome do recurso do feed, no formato

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

string

A categoria de alto nível a que este serviço doméstico pertence. Por exemplo: encanador, eletricista etc.

string

O tipo de vaga na categoria a que o serviço doméstico pertence. Por exemplo: unclog_drain, install_faucet são os tipos de trabalho na categoria de encanador.

string

O nome do recurso a ser invalidado.

Por exemplo, para um recurso de retirada, o nome precisa ter o formato partners/{partner_id}/pickups/{pickup_id}. As implementações PRECISAM remover as versões armazenadas em cache do recurso identificado.

string

ID do serviço do comerciante.

int64

Início do horário disponível em segundos no fuso horário UTC desde a época do Unix.

int64

Duração do horário disponível em segundos.

OrderedTickets

Número de ingressos solicitados por tipo.

Price

O preço total (sem tributos) deste item de linha.

BookingStatus

Status do item de linha.

string

ID de um tipo de ingresso.

int32

Número de ingressos solicitados para esse tipo.

string

Obrigatório. O pai, que é proprietário desse conjunto de status do comerciante. Formato: partners/{partner_id}/merchants

int32

Obrigatório. O número máximo de itens para retornar. O servidor pode reduzir o tamanho da página.

string

Opcional. O valor nextPageToken retornado de um ListMerchantStatusResponse anterior, se houver.

BookingInventoryStatus

Opcional. Restrição opcional para filtrar resultados por status da reserva do inventário.

WaitlistInventoryStatus

Opcional. Restrição opcional para filtrar resultados por status do inventário da lista de espera.

GeoMatchingStatus

Opcional. Restrição opcional para filtrar resultados por status de correspondência geográfica.

MerchantStatus

Lista de status dos comerciantes que atendem às condições do filtro.

string

Token para recuperar a próxima página de resultados. Não haverá mais resultados na lista, se ela estiver vazia.

string

Nome do recurso do feed, no formato

• partners/{partner_id}/feeds/merchants
• partners/{partner_id}/feeds/services
• partners/{partner_id}/feeds/availability

int32

O número máximo de itens para retornar.

string

O valor next_page_token retornado de uma solicitação List anterior, se houver.

State

Restrição opcional para filtrar os resultados por estado do feed.

TimeRange

Restrição opcional para filtrar os resultados por limites superior e inferior. Se start_time não for definido, o padrão será o início do horário Unix. Se end_time não for definido, o padrão será agora.

FeedStatus

Lista cronológica inversa de status para os feeds enviados. O número máximo de itens retornados depende do campo page_size na solicitação.

string

Token para recuperar a próxima página de resultados. Se esse campo estiver vazio, não haverá mais resultados na lista.

string

Código de idioma IETF BCP 47, como "en", "mas", "zh-Hant", "de-CH-1901". Consulte http://www.w3.org/Internacional/articles/language-tags/.

string

Mensagem na localidade acima (UTF-8).

string

O código de um lugar no banco de dados do Google Places e no Maps. Consulte https://developers.google.com/places/web-service/place-id para saber mais sobre os IDs de lugar. Se esse valor for incluído, o Google corresponderá o local ao lugar relevante.

string

Nome, telefone, URL e localização geográfica do local são usados para correspondê-lo com lugares no Google Maps.

Esse campo é opcional, mas pode ser necessário em alguns contextos. Por exemplo, um Service.location sem nome não corresponde a uma entidade empresarial, mesmo que elas estejam no mesmo endereço. (opcional)

string

Número de telefone público do local, incluindo os códigos de país e de área, por exemplo, +14567891234. (opcional)

string

URL do site público do local. (opcional)

GeoCoordinates

Informações geográficas do local, incluindo latitude, longitude e endereço. (opcional)

LocationType

O tipo do local. Deve ser fornecido se o local for fornecido para um serviço.

string

Referência exclusiva do local no serviço. Esse código pode ser usado para se referir ao lugar em outros campos. Por exemplo: no formulário de admissão personalizado, um conjunto de IDs de local pode ser usado para especificar as opções de local de retirada. Se esse campo for definido, o código precisará ser exclusivo em um serviço. (opcional)

string

O nome do recurso do comerciante, que tem o formato partners/{partner_id}/merchants/{merchant_id}.

string

merchant_name, telefone, URL e localização geográfica são usados para corresponder o inventário do parceiro aos comerciantes no Google Maps. Essas informações não serão exibidas.

Nome do comerciante.

string

O número de telefone público do comerciante, incluindo os códigos de país e de área, por exemplo, +55 (14) 5678-91234

string

O URL do site público do comerciante.

GeoCoordinates

Informações geográficas do comerciante, incluindo latitude, longitude e endereço.

string

A categoria do negócio na plataforma do agregador.

int64

O uso desse campo está suspenso.

uint32

Taxa de tributo do comerciante em pontos base (um centésimo de um por cento). Por exemplo, se a alíquota for de 7,5%, o campo exibirá 750.

Se esse campo não for definido ou mostrar o valor 0, o preço total cobrado do usuário por qualquer serviço do comerciante será aquele especificado em Service.price. Considera-se que esse valor está isento de impostos ou já inclui os tributos aplicáveis. Os impostos não serão exibidos para o usuário em outro item de linha.

Se o campo for definido como qualquer valor diferente de zero, o preço total cobrado pelo comerciante incluirá o valor do serviço e o tributo calculado com base na alíquota informada. As frações da menor unidade monetária (por exemplo, frações de um centavo) serão arredondadas para o número par mais próximo. Os tributos aparecerão em outro item de linha.

Este campo está obsoleto. Use tax_rate.

TaxRate

A alíquota de imposto do comerciante. Se esse campo for definido, ele modificará tax_rate_basis_points, que está obsoleto. Uma mensagem vazia (por exemplo, tax_rate { }) redefinirá a alíquota de imposto aplicada para zero.

PaymentRestrictions

Restrições às formas de pagamento aceitas pelo comerciante. Supõe-se que não existam restrições se esse campo não estiver definido.

PaymentOption

Opções de pagamento disponíveis para esse comerciante. Os serviços dele poderão limitar cada opção de pagamento permitida.

PaymentProcessorConfig

Configuração para um processador de pagamentos tokenizado, se o comerciante oferecer suporte a esse recurso.

TokenizationConfig

Configuração para um processador de pagamentos tokenizado, se o comerciante oferecer suporte a esse recurso.

Terms

Os Termos e Condições do comerciante, exibidos ao usuário quando um serviço é agendado pelo Reservar com o Google. Além desses, os Termos e Condições do parceiro agregador são sempre exibidos ao usuário e não podem ser disponibilizados aqui.

string

String opaca que identifica a marca voltada para o consumidor que será usada ao mostrar a atribuição de parceiro. Esse campo permite que parceiros com várias marcas desse tipo especifiquem comerciantes para todas elas no mesmo feed.

Uma marca consiste em propriedades voltadas para o consumidor, como nome, logotipo, Termos de Serviço e Política de Privacidade.

Se houver apenas uma marca de parceiro voltada para o consumidor, esse campo não precisará ser definido e poderá ser ignorado.

Se o parceiro...

não tiver várias marcas voltadas para o consumidor? --> Ignore esse campo

tiver várias marcas configuradas?

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

Observação: a maioria dos parceiros não precisa definir esse campo. Se um parceiro quiser usá-lo, precisará entrar em contato conosco para configurar marcas separadas, incluindo a padrão.

MerchantMatchingHints

Dicas para ajudar o Google a corresponder um comerciante a um lugar no Google Maps. Observação: a maioria dos parceiros não precisa definir esse campo, já que o Google fará a correspondência entre os comerciantes e os lugares no Google Maps usando as informações enviadas acima. (Opcional)

ServiceAttribute

Definições de qualquer atributo de serviço usado para descrever os serviços deste comerciante. (opcional)

ActionLink

Opcional. Um URL de ação com idioma associado, lista de países restritos, tipo e plataforma opcional que indica em qual plataforma essa ação deve ser realizada.

Advisement

Opcional. Orientações gerais de um comerciante específico para um usuário que entrou em uma lista de espera pelo Reservar com o Google. Os campos de texto individuais no aviso devem ser limitados a 100 bytes.

string

O código de um lugar no banco de dados do Google Places e no Maps. Consulte https://developers.google.com/places/web-service/place-id para saber mais sobre os IDs de lugar.

string

O nome do recurso de status do comerciante, que tem o formato partners/{partner_id}/merchants/{merchant_id}/status

string

Nome do comerciante fornecido pelos parceiros.

GeoCoordinates

Os parceiros forneceram informações geográficas do comerciante.

ProcessingStatus

Status de processamento do comerciante.

BookingStatus

Status relacionado à integração completa de reservas.

WaitlistStatus

Status relacionado à integração da lista de espera.

PlaceInfo

Local geográfico correspondente desse comerciante. Vai ficar vazio se o comerciante não tiver correspondência geográfica.

LocalServicesMatchInfo

Os anúncios do Serviços Locais correspondem a esse comerciante. Vai estar vazio se não for um comerciante de serviços locais ou não corresponder a nenhum provedor.

DirectUrl

Uma lista de URLs para demonstrar o conteúdo do inventário atual do comerciante. Isso não significa que o inventário esteja realmente sendo veiculado, e o URL pode ser diferente dos visíveis ao público.

bool

Verdadeiro se o comerciante tiver inventário nos próximos 30 dias. não garante que o comerciante será atendido.

UrlType

Tipo desse URL.

string

URL que pode mostrar este comerciante.

MatchedProvider

Provedores de serviços correspondentes. Um comerciante pode ser associado a vários provedores de serviços.

int64

ID de cliente externo dos Serviços Locais do Google.

string

Categorias de serviço local (indústrias). Por exemplo: "encanador" e "carpet_cleaning".

string

Nome do lugar.

string

Endereço formatado no idioma local.

string

ID do lugar do Google para esse lugar. Pode ser usado para construir um URL do Google Maps ou buscar mais detalhes do lugar. Consulte https://developers.google.com/places/web-service/place-id para ver exemplos de uso.

bool

Verdadeiro se o comerciante tiver o serviço de lista de espera. não garante que o comerciante será atendido.

Money

Valor mínimo.

Money

Valor máximo.

Price

O valor que o usuário poderá ser cobrado se não comparecer no evento da reserva.

PriceType

Define como a taxa é determinada a partir da disponibilidade.

string

Nome do recurso do pedido: partners/{partner ID}/orders/{order ID}

ClientInformation

Informações pessoais do cliente que está fazendo o pedido.

PaymentInformation

São informações sobre transações de pagamento relacionadas ao pedido.

string

ID do comerciante a que todos os serviços deste pedido pertencem.

LineItem

Itens de linha neste pedido.

FulfillmentOption

Opções de processamento do pedido disponíveis para um link de ação on-line de pedido.

PrepaymentStatus

Status de pré-pagamento da reserva. Se o prepayment_status for PREPAYMENT_PROVIDED ou PREPAYMENT_REFUNDED, o payment_transaction_id conterá o código da transação exclusivo associado.

string

Identificador exclusivo de uma transação de pagamento associada à reserva. Se não for aplicável, esse campo estará vazio.

string

Código usado para identificar a opção de pagamento.

Esse código é global para todo o agregador. Se você reutilizar um valor em diversos comerciantes, um usuário poderá pagar com a opção correspondente em todos eles.

Nesse caso, quando você atualiza o valor de uma opção de pagamento em um comerciante, todas as outras opções com o mesmo código em outros comerciantes também serão modificadas. Portanto, utilize valores idênticos em todas as opções de pagamento com o mesmo código para evitar comportamentos prejudiciais.

string

Nome da opção de pagamento. Pode ser visível para o usuário.

string

Descrição da opção de pagamento, Pode ser visível para o usuário.

Price

O preço da opção de pagamento.

TaxRate

Alíquota de impostos dessa opção de pagamento. Se esse valor for definido, ele modificará o campo tax_rate no comerciante ou no serviço. Uma mensagem vazia (por exemplo, tax_rate { }) redefinirá a alíquota de imposto aplicada para zero.

PaymentOptionType

Tipo dessa opção de pagamento. Uso único para atendimentos sem hora marcada, várias utilizações para pacotes e ilimitado para assinaturas.

int64

Em quantas sessões essa opção de pagamento pode ser usada. Válido apenas para várias sessões / pacotes, em que o valor deve ser > 1.

TimeRange

A opção de pagamento pode ser comprada dentro desse intervalo.

TimeRange

A opção de pagamento pode ser usada nesse intervalo (por exemplo, preço especial para janeiro de 2017). Se esse valor for definido, ele modificará valid_duration e activation_type.

Duration

Duração da validade da opção de pagamento (por exemplo, assinatura de 30 dias).

ActivationType

Define como a data de início da validade é determinada para essa opção de pagamento.

UserPurchaseRestriction

Restringe os usuários qualificados para comprar com essa opção de pagamento. Pode ser usado para restringir uma opção de pagamento promocional a um subconjunto de usuários. Se esse campo não for definido, todos os usuários estarão qualificados.

Processor

Define o parceiro do processador de pagamentos a que essa configuração se aplica.

string

A chave usada para identificar esse comerciante com o processador de pagamentos.

Para o Stripe, consulte: https://stripe.com/docs/dashboard#api-keys Para o Braintree, consulte: https://articles.braintreepayments.com/control-panel/important-gateway-credentials

string

O número da versão da API enviado ao processador de pagamentos com as solicitações de pagamento.

CreditCardRestrictions

Restrições aos cartões de crédito aceitos pelo comerciante. Presumimos que todos os cartões de crédito sejam aceitos se esse campo não estiver definido. A lista de cartões aceitos pelo CreditCardType aumentará ao longo do tempo. Com isso, se você deixar esse campo vazio, a configuração ficará sujeita às alterações futuras.

Price

Uma taxa que pode variar de acordo com o método de entrega.

Price

Uma taxa para processar a forma de pagamento do usuário.

Price

Uma taxa extra para um serviço.

Price

Uma taxa para o local/instalação.

Price

Tributos por ingresso.

string

O país, especificado usando o código de país ISO 3166-1 alfa-2, por exemplo, "EUA" (obrigatório)

string

A localidade, por exemplo, "Mountain View". (obrigatório).

string

A região, por exemplo, "CA". Este campo é obrigatório apenas em países onde a região geralmente faz parte do endereço. (opcional).

string

O código postal, por exemplo, "94043". (obrigatório).

string

O endereço, por exemplo, "1600 Amphitheatre Pkwy". (obrigatório)

int64

O preço em microunidades da moeda. As frações da menor unidade monetária serão arredondadas para o número inteiro mais próximo. Por exemplo, US$ 2,5 centavos serão arredondados para 2 centavos, 3,5 centavos, para 4 centavos, 0,5 centavo, para 0 centavos, 2,51 centavos, para 3 centavos.

string

A moeda do preço definida no formato ISO 4217.

string

Uma string opcional e opaca que identifica a opção de preço associada ao preço estendido.

double

Um valor singular. Por exemplo: 5,6

RangeValue

Um intervalo de valores que também podem ser abertos ou limitados. Exemplos: * No mínimo 5,5 * No máximo 5,5 * 5,5 a 6,5

double

Valor mínimo.

double

Valor máximo.

double

Valor médio da classificação (obrigatório quando number_of_ratings for maior que 0). Precisa estar no intervalo [1, 5], podendo ser omitido se number_of_ratings for zero.

uint64

Número de classificações usadas no cálculo do valor (obrigatório).

string

URL desta fonte de mídia. O Google rastreará a mídia hospedada nesse URL.

MediaType

Tipo dessa fonte de mídia.

Text

Legenda da mídia compatível com i18n. Apenas texto simples é aceito. Todos os componentes HTML serão removidos. (opcional)

Attribution

Informações de atribuição sobre a fonte da mídia. Defina esse campo se for necessário dar crédito ao fotógrafo ou à agência. (opcional)

string

Obsoleto. Use localized_ caption.

Text

Texto de crédito ao fotógrafo ou à agência compatível com i18n. Será exibido junto com a mídia de origem. Esse campo só aceita texto simples. Todos os componentes HTML serão removidos (a atribuição com base em hiperlinks não é compatível).

string

Obsoleto. Use localized_text.

ServiceAvailability

A disponibilidade do serviço usada para substituir as existentes.

string

Código opcional de um membro da equipe que presta o serviço. Esse campo identifica o membro da equipe em todos os comerciantes, serviços e registros de disponibilidade. Ele também precisa ser estável ao longo do tempo para permitir a correlação com reservas anteriores. Esse campo precisa ser definido se staff_name estiver presente.

string

Nome opcional de um membro da equipe que fornece o serviço. Esse campo será exibido de forma legível para os usuários que fizerem uma reserva, não podendo ser um identificador opaco. Esse campo precisa ser definido se staff_id estiver presente.

string

Código opcional para a sala em que o serviço está localizado. Esse campo identifica a sala em todos os comerciantes, serviços e registros de disponibilidade. Ele também precisa ser estável ao longo do tempo para permitir a correlação com reservas anteriores. Esse campo precisa ser definido se room_name estiver presente.

string

Nome opcional para a sala em que o serviço está localizado. Esse campo será exibido aos usuários que fizerem um agendamento e deve ser legível por humanos, em vez de um identificador opaco. (opcional, mas obrigatório se o room_id estiver presente) No restaurante, o nome de uma sala só deve ser usado em áreas de estar, como o bar ou o pátio, e não para cardápios com preço fixo, atividades especiais ou qualquer outro valor que não seja o quarto (como reserva ou jantar). É altamente recomendável que não haja uma sala associada à área de estar padrão.

int32

Aplicável somente para refeições: a quantidade de pessoas que podem ser acomodadas durante esse período. Um restaurante poderá ser associado a vários espaços ao mesmo tempo, cada um especificando um group_size diferente, se, por exemplo, duas, três ou quatro pessoas puderem fazer uma reserva.

int64

Aviso com antecedência mínima em segundos necessária para cancelar um agendamento on-line. (opcional)

Price

Taxa para cancelamento feito dentro do período de aviso com antecedência mínima.

Price

Taxa de não comparecimento quando o cliente não cancelou a reserva.

AdmissionPolicy

Política de admissão aplicada a este serviço. Se esse campo não for definido, o padrão será TIME_STRICT. (opcional)

CancellationPolicy

Política de cancelamento das regras de agendamento. (obrigatório para parceiros da indústria de "Coisas legais para fazer")

int64

Duração (em segundos) entre a última reserva e o início da disponibilidade.

int64

Duração (em segundos) entre a última reserva e o horário de término da disponibilidade. Se esse campo estiver presente, o campo "admission_policy" precisará ser definido como TIME_FLEXIBLE para indicar que os usuários podem usar os ingressos comprados após o início dos espaços.

string

O nome do recurso do serviço, que tem o formato de partners/{partner_id}/merchants/{merchant_id}/services/{service_id}.

string

Nome do serviço, por exemplo, "corte de cabelo masculino". Obsoleto. Use localized_service_name.

Text

Nome do serviço, por exemplo, "corte de cabelo masculino". Possivelmente em várias localidades.

string

Descrição do serviço exibida ao usuário. Obsoleto. Use localized_description.

Text

Descrição do serviço exibida ao usuário.

Esse campo é compatível com formatação de texto simples e HTML. Ao contrário das seções de texto simples, é possível criar layouts personalizados aqui usando cabeçalhos, parágrafos, listas e algumas tags de frase. Leia atentamente as instruções e observações a seguir para garantir a melhor experiência do usuário.

Tags de formatação compatíveis com HTML:

Tags de cabeçalho: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
As tags de cabeçalho podem ser usadas para exibir títulos e subtítulos. Por exemplo, {h1}Itinerário{/h1} exibirá o texto inline como o título mais importante da seção. Todas as tags, estilos ou atributos HTML internos serão ignorados. Por exemplo, {h1 style=".."} será tratado da mesma forma que {h1}. Somente texto bruto será preservado.

Tag de parágrafo: <p>
A tag de parágrafo pode ser usada para destacar uma introdução ou um conteúdo detalhado. Todas as tags, estilos ou atributos internos serão ignorados, com algumas exceções: <br>, <strong> e <em>. Consulte a seção de tag de frase abaixo para mais detalhes.

Tags de lista: <ul>, <ol>, <li>
A tag <ul> pode ser usada com <li> para exibir listas não ordenadas, e <ol> pode ser utilizada com <li> para mostrar listas ordenadas. Essa é uma boa maneira de apresentar listas de verificação, programações ou qualquer outra lista adequada aos seus casos de uso.
Exemplo: para mostrar uma lista de elementos de uma viagem de cruzeiro:
<ol>
<li>Uma vista incrível para o mar e chances de brincar com a vida selvagem.</li>
<li>Serviços e serviços de viagem cuidadosamente elaborados.</li>
<li>Preço mais baixo garantido.</li>
</ol>
Observação: apenas <li> crianças com menos de <ul> ou <ol> serão convertidas. Todas as outras filhas serão descartadas. Além disso, todas as tags, atributos e estilos internos serão ignorados. Preservamos apenas o conteúdo de texto puro.

Tag de divisão: <div>
Todas as tags internas compatíveis com a {div} serão analisadas com as regras mencionadas acima. Portanto, {div} não significa agrupamento ou recuo. Além disso, todos os atributos e estilos internos serão ignorados.

Tags de frase: <br>, <strong>, <em>:
Somente as três tags mencionadas acima são compatíveis. É possível usar <br> para quebra de linhas em parágrafos, e <strong>/<em> para destacar textos importantes. Todas as outras tags de frase serão ignoradas.

Tags não compatíveis:

• As tags {html}, {header} e {body} não são permitidas.
• Outras tags não mencionadas acima não são compatíveis (por exemplo, <table>, <td> etc.).
  URLs, âncoras e links serão removidos e nunca serão exibidos aos usuários finais. Se você quiser usar fotos para proporcionar uma melhor experiência do usuário, utilize o campo "related_media" abaixo e envie URLs de fotos.
  

Observações importantes:

• Tente não usar outras tags, exceto as compatíveis mencionadas acima, porque o conteúdo das tags não aceitas será removido, o que causará uma experiência indesejada para o usuário.
  
• Evite estruturas muito aninhadas, como mais de três níveis de cabeçalho diferentes ou listas aninhadas. Use uma estrutura simples e direta para criar uma melhor experiência do usuário.
  
• Se os layouts compatíveis no momento não forem suficientes para seus casos de uso, entre em contato com a equipe do Reservar com o Google.
  
• O tamanho máximo recomendado é de 32.000 caracteres.

Price

O preço do serviço.

PriceInterpretation

Descreve como o preço é interpretado e exibido ao usuário. Pode ser usado por qualquer indústria, exceto restaurantes e coisas legais para fazer, a fim de configurar a exibição do preço do serviço.

SchedulingRules

Regras para reservar/cancelar um horário.

PrepaymentType

Indica se um pré-pagamento é obrigatório, opcional ou não aceito.

PrepaymentTerms

Termos referentes à conclusão do pré-pagamento.

ServiceIntakeForm

Obsoleto. Use intake_form e per_ticket_intake_form.

ServiceIntakeForm

Formulário que solicita informações adicionais do usuário quando ele reserva esse serviço. (opcional)

ServiceIntakeForm

Formulário que solicita informações adicionais do usuário quando ele reserva esse serviço. Precisa ser preenchido uma vez para cada ingresso reservado. (opcional)

TaxRate

Taxa de tributos do serviço. Se esse campo for definido, ele modificará o tax_rate definido no nível do comerciante. Uma mensagem vazia (por exemplo, tax_rate { }) redefinirá a alíquota de imposto aplicada para zero.

string

Uma lista de códigos que fazem referência às opções de pagamento que podem ser usadas para pagar por esse serviço. As opções de pagamento reais são definidas no nível do comerciante e também podem ser compartilhadas entre vários deles.

Deposit

Define como um depósito pode ser cobrado do usuário. Modifica o depósito de serviço, se especificado. Quando você deixa a mensagem de depósito vazia, todos os depósitos de nível de serviço são removidos. (opcional)

NoShowFee

Define uma taxa de não comparecimento que pode ser cobrada do usuário. Modifica a taxa de não comparecimento do serviço, se especificada. Quando você deixa a mensagem NoShowFee vazia, todas as taxas de não comparecimento são removidas. (opcional)

RequireCreditCard

Indica se o usuário precisa inserir os dados de um cartão de crédito para reservar este serviço. Esse campo pode ser modificado no nível da disponibilidade. (opcional)

ActionLink

Link de ação relacionado a este serviço. Se houver um link de ação, defina o tipo no serviço, conforme mostrado a seguir.

ServiceType

Tipo predefinido desse serviço. (opcional)

TicketType

Tipos de ingressos compatíveis que podem ser reservados/comprados para este serviço. (opcional)

RelatedMedia

Fotos relacionadas a este serviço. O Google rastreará e armazenará a mídia para garantir que elas sejam exibidas aos usuários finais da maneira mais eficiente. (opcional)

ServiceAttributeValueId

Valores de atributos que se aplicam a este serviço (opcional). Cada serviço pode ter zero ou mais valores para cada atributo definido no comerciante correspondente. (opcional)

WaitlistRules

Regras para entrar na lista de espera.

TicketingVerticalSpecificData

Informações adicionais exclusivas da indústria de ingressos para eventos. (opcional)

IntegrationType

Profundidade da integração que oferecemos para este serviço. (opcional) Não relevante para parceiros com integração inicial. O suporte completo não será ativado para esses parceiros.

PerOrderFee

Taxas no nível do pedido para a compra desse serviço. (opcional)

ToursAndActivitiesContent

Campos de conteúdo específicos a tours e atividades.

Location

Locais relacionados a esse serviço. OBSERVAÇÕES IMPORTANTES: se diversos locais relacionados a esse serviço tiverem sido visitados ou se START_LOCATION for diferente de VISITED_LOCATION, o START_LOCATION precisará ser especificado. Exemplo: em um tour guiado de bicicleta que visita três lugares, o ponto de início precisa ser definido. Em um tour de ônibus com ponto de encontro no saguão do hotel e que depois segue para o local visitado, é preciso especificar o lugar de encontro.

Rating

Avaliação dos usuários para esse serviço como uma métrica agregada em todas as avaliações.

HomeServiceData

Informações adicionais exclusivas da indústria de serviços domésticos. (opcional)

VirtualSession

Opcional. Informações sobre sessão virtual. Ele é necessário para ativar serviços virtuais.

DirectMerchantPayment

Opcional. Informações adicionais que precisam ser incluídas se o serviço exige que o usuário pague diretamente ao comerciante. OBSERVAÇÃO IMPORTANTE: o RwG não está envolvido nessa transação. Ele será obrigatório se virtual_session estiver definido e o serviço não for sem custo financeiro ou se prepayment_type NÃO estiver definido como REQUIRED.

ChargeTiming

Quando a cobrança ocorrerá em relação ao momento da compra.

int64

Tempo em segundos antes do horário de início do serviço em que o pagamento é cobrado do usuário. Este campo só deve ser definido quando ChargeTiming for CHARGE_LATER.

string

Um identificador que identifica exclusivamente esse atributo de serviço entre outros para o mesmo comerciante, por exemplo, "tipo de conta".

string

Um nome visível ao usuário para esse atributo, por exemplo, "Tipo de conta".

Value

Todos os valores possíveis para este atributo de serviço.

string

Um identificador que identifica exclusivamente esse valor, entre outros, para esse atributo de serviço. Por exemplo, "pessoal".

string

Um nome para o valor visível ao usuário, por exemplo, "Pessoal".

string

ID de um atributo, conforme definido em Merchant.service_attribute, por exemplo, "service-type".

string

Código do valor desse atributo, por exemplo, "corte de cabelo". Precisa corresponder a um value_id presente na definição.

string

Nome do recurso do serviço a que esse valor será aplicado, no formato partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Timestamp

Se esse campo for definido, consideraremos as entidades de disponibilidade indicadas como um instantâneo completo de [start_time_restrict, end_time_restrict]. Ou seja, todas as disponibilidades existentes serão excluídas se a seguinte condição for verdadeira:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

Se uma mensagem de duração for definida, a condição será ainda mais restritiva:

  availability.duration == duration_restrict

Se uma mensagem resources_restrict for definida, a condição será ainda mais restritiva:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

Esses campos normalmente são usados para enviar uma atualização completa da disponibilidade em um determinado período.

Quando você define start_time_restrict, mas não end_time_restrict, todo o período desde o valor definido em start_time_restrict é considerado.

Timestamp

Quando você define end_time_restrict, mas não start_time_restrict, todo o período até o end_time_restrict é considerado.

Duration

Definir a duração restringe ainda mais o escopo da atualização à disponibilidade com período correspondente.

Resources

Definir resources_restrict restringe ainda mais o escopo da atualização a esse conjunto de recursos. Todos os campos de código dos recursos precisam corresponder.

Availability

A nova lista de disponibilidade.

ServiceIntakeFormField

Campos que serão exibidos para o usuário.

bool

Se esse valor for verdadeiro, o formulário será exibido para clientes novos. Obsoleto. Essa funcionalidade não é compatível com formulários de entrada.

bool

Se esse valor for verdadeiro, o formulário será exibido para clientes recorrentes. Obsoleto. Essa funcionalidade não é compatível com formulários de entrada.

string

String de um parceiro agregador que identifica o campo de um formulário. Esse código precisa ser igual àquele na resposta do campo de formulário correspondente e ser exclusivo nos formulários de entrada de ingresso e nível de serviço. (obrigatório)

FieldType

Tipo deste campo.

string

Texto deste campo mostrado ao usuário. Obsoleto. Use localized_label.

Text

Texto deste campo mostrado ao usuário. O campo pode ser exibido para usuários de várias localidades. (obrigatório)

string

Defina apenas se o tipo de campo for LOCATION_SEARCH. Use o "location_id" no campo "location" para especificar o valor do local.

Text

Defina apenas se o tipo de campo for MULTIPLE_CHOICE, CHECKBOXES ou DROPDOWN. Usado para enumerar opções possíveis.

bool

Indica se um usuário precisa responder a este campo.

bool

Indica se um valor personalizado é permitido, além de respostas predefinidas. Isso só é aplicável quando o tipo de campo é LOCATION_SEARCH. (opcional)

Text

Opções adicionais fornecidas além dos valores fornecidos. Aplicável apenas quando o tipo de campo é LOCATION_SEARCH. Por exemplo: além da lista de locais fornecida, outra opção disponível pode ser "Entrar em contato com o fornecedor mais tarde". (opcional)

string

Se essa pergunta for exibida apenas quando o usuário reservar determinados tipos de ingresso, defina esse campo como o conjunto de códigos dos tipos de ingresso aplicáveis. Deixe-o vazio se a pergunta for mostrada todas as vezes.

Text

O texto de dica para entrada, que aparece como um marcador de posição de texto. Aplicável apenas quando o tipo de campo é SHORT_ANSWER ou PAR. (opcional)

int32

Uma alíquota de impostos em milionésimos de 1% com seis decimais de precisão. Por exemplo, se a alíquota for de 7,253%, o campo exibirá 7253000.

Se esse campo não for definido ou mostrar o valor 0, o preço total cobrado do usuário por qualquer serviço do comerciante será aquele especificado em Service.price. Considera-se que esse valor está isento de impostos ou já inclui os tributos aplicáveis. Os impostos não serão exibidos para o usuário em outro item de linha.

Se o campo for definido como qualquer valor diferente de zero, o preço total cobrado pelo comerciante incluirá o valor do serviço e o tributo calculado com base na alíquota informada. As frações da menor unidade monetária (por exemplo, frações de um centavo) serão arredondadas para o número par mais próximo. Os tributos aparecerão em outro item de linha.

string

Opcionalmente, o URL dos Termos e Condições.

string

O texto a ser exibido para o usuário. Use localized_text mostrado a seguir para novas integrações.

Text

O texto localizado que será exibido ao usuário.

string

Valor de texto em uma localidade desconhecida. Obrigatório somente se localized_value estiver vazio. A localidade desse valor depende do parceiro ou do provedor de serviços e não representa um idioma específico.

LocalizedString

Valores de texto por localidade. Opcional.

string

O ID do tíquete é usado para diferenciar os tipos de tíquete do mesmo serviço e precisa ser exclusivo.

string

Breve descrição desse TicketType.

Pode ser visível para o usuário, por exemplo, "adulto", "crianças", "veterano", "linha J" etc. Cada tipo de ingresso deve ter uma descrição a ser exibida ao usuário. Obsoleto. Use localized_short_description.

Text

Breve descrição desse ingresso compatível com i18n.

Pode ser visível para o usuário, por exemplo, "adulto", "crianças", "veterano", "linha J" etc. Cada tipo de ingresso deve ter uma descrição a ser exibida ao usuário. É possível especificar valores separados para cada localidade.

Price

Preço de um único ingresso desse tipo, sem tributos. A taxa de tributos do serviço é aplicada aos ingressos.

PerTicketFee

Taxas adicionais aplicadas à compra deste ingresso. (opcional)

string

Descrição de opções adicionais para esse tipo de ingresso, se houver. Obsoleto. Use localized_option_description.

Text

Descrição de opções adicionais para esse tipo de ingresso, se houver. É possível especificar valores separados para cada localidade.

Opções adicionais são úteis quando o tipo de ingresso representa várias dimensões.

Exemplo 1: um ingresso de admissão com tipos diferentes "adulto" ou "criança", e cujo idioma é uma opção adicional, a lista de TicketType seria: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } }

Exemplo 2: para um aluguel de caiaque de várias horas com complemento opcional de bolsa impermeável, a short_description poderia ser "3 horas", e a option_description, "com bolsa impermeável" ou "sem bolsa impermeável": - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } }

É opcional, mas, se qualquer tipo de ingresso no serviço tiver esse campo definido, você precisará incluir esse valor para todos os outros tipos. É possível usar uma option_description padrão. Por exemplo, [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] não é uma lista válida.

Apenas duas tags de formatação HTML são compatíveis: e
. Elas devem ser usadas para especificar opções com um título e uma descrição detalhada, por exemplo: "Assentos premium
Essa opção oferece assentos almofadados em áreas privativas, incluindo TVs privadas e serviço de entrega de comida e bebida no banco, além de vistas privilegiadas do campo."

EventCategory

Categoria do evento. Definido somente quando o evento se encaixa em uma das categorias predefinidas. (opcional)

string

URL do evento no site do parceiro. (opcional)

Entity

Lista de entidades relacionadas ao evento. (opcional)

AttendanceMode

Obrigatório. O tipo de participação no evento.

string

Opcional. URL em que o evento pode ser assistido.

Text

Opcional. Organizador que organiza o evento.

string

Opcional. URL do organizador que hospeda o evento.

OrganizerType

Opcional. O tipo de organizador.

string

Obrigatório. URL das páginas em que as informações ou descrições do evento podem ser encontradas.

EventState

Opcional. Estado do evento.

string

Identificador exclusivo da entidade no banco de dados do parceiro. (opcional)

string

Nome da entidade. (obrigatório)

string

URL da página da Web que descreve a entidade de forma clara. É a página da Web da entidade no site do parceiro, se houver. Para outros URLs públicos, use relevant_url em public_identification_data. (opcional)

EntityType

Tipo de entidade. (opcional)

EntityRole

Papel da entidade no evento. (opcional)

PublicIdentificationData

Referências públicas da entidade. (opcional)

string

URL público de qualquer página da Web dedicada apenas ao tópico. Pode incluir sites oficiais, discografias, plataformas de mídia social, wikipedia ou páginas imdb, por exemplo, https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan. (opcional)

string

Identificador musicbrainz de 36 caracteres do artista ou de outras entidades musicais, se aplicável. Consulte https://musicbrainz.org/doc/MusicBrainz_Identifier. (opcional)

Timestamp

O limite inferior do período.

Timestamp

O limite superior do período.

map<string, string>

Uma configuração de tokenização geralmente tem um tokenization_parameter, em que a chave é "gateway" e o valor é o nome do processador.

Os demais parâmetros dependem do processador. Consulte a documentação do Google Pay para mais informações.

Exemplo do Braintree: tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Exemplo do Stripe: tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" }

Exemplo do Adyen: tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" }

BillingInformationFormat

Inclua no token as informações de faturamento e a forma de pagamento do usuário presentes no Google Pay (veja acima). Quando você deixa o campo vazio, o comportamento é o mesmo que especificar o campo MIN.