Package google.maps.booking.v1alpha

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

repeat_every

ExtendedServiceAvailability

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)

ScheduleException

As mensagens de ScheduleException representam períodos reservados/indisponíveis no dia de trabalho, que são exceções à recorrência descrita acima. Como os horários são reservados, a lista de exceções deve ser atualizada para mostrar os períodos indisponíveis. A recorrência não pode ser modificada.

Campos

Campos
`time_range`	`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.

time_range

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.

SchedulingRuleOverrides

Regras de agendamento no nível de disponibilidade.

Campos

Campos
`last_bookable_sec`	`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.
`first_bookable_sec`	`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.
`last_online_cancellable_sec`	`int64` Se definido, indica a última vez (em segundos desde a época do Unix) que esse horário disponível específico pode ser cancelado pelo Reservar com o Google. Este campo vai substituir todas as regras de cancelamento no nível do serviço. (opcional)

last_bookable_sec

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.

first_bookable_sec

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.

last_online_cancellable_sec

int64

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

BatchDeleteGenericRecordsRequest

A solicitação em lote para excluir registros do tipo de feed especificado.

Campos

Campos
`parent`	`string` Nome do recurso, que tem o formato - `partners/{partner_id}/feeds/{feed_name}`.
`records[]`	`GenericDeleteRecord` Registros a serem excluídos. No máximo 1.000 registros são permitidos em uma chamada de API.

parent

string

Nome do recurso, que tem o formato - partners/{partner_id}/feeds/{feed_name}.

records[]

GenericDeleteRecord

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

BatchPushGenericRecordRequest

A solicitação em lote para inserir e/ou atualizar registros do tipo de feed especificado no URL da solicitação.

Campos

Campos
`parent`	`string` Nome do recurso, que tem o formato - `partners/{partner_id}/feeds/{feed_name}`.
`records[]`	`GenericRecord` Registros a serem inseridos e/ou atualizados. No máximo 1.000 registros são permitidos em uma chamada de API.

parent

string

Nome do recurso, que tem o formato - partners/{partner_id}/feeds/{feed_name}.

records[]

GenericRecord

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

BatchReplaceServiceAvailabilityRequest

Solicitação em lote para substituir vários horários disponíveis de Service.

Campos

Campos
`parent`	`string` Formato de `partners/{partner_id}`.
`extended_service_availability[]`	`ExtendedServiceAvailability` Disponibilidade de serviço estendida usada para substituir os horários disponíveis existentes.

parent

string

Formato de partners/{partner_id}.

extended_service_availability[]

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

BatchReplaceServiceAvailabilityResponse

Resposta em lote para substituir vários horários disponíveis de Service. Serão incluídos nesta mensagem somente aqueles que forem atualizados com êxito.

Campos

Campos
`extended_service_availability[]`	`ExtendedServiceAvailability` As mensagens de disponibilidade de serviço estendida que foram atualizadas com sucesso para substituir os horários disponíveis existentes.

extended_service_availability[]

ExtendedServiceAvailability

As mensagens de disponibilidade de serviço estendida que foram atualizadas com sucesso para substituir os horários disponíveis existentes.

Reserva

Reserva para um espaço de inventário

Campos
`name`	`string` Nome do recurso da reserva: `partners/{partner ID}/bookings/{booking ID}`
`merchant_id`	`string` ID do comerciante para o espaço
`service_id`	`string` ID do serviço do comerciante
`start_time`	`Timestamp` Início do horário disponível
`duration`	`Duration` Duração do horário disponível
`client_information`	`ClientInformation` Informações pessoais do cliente que está marcando o horário
`status`	`BookingStatus` Status da reserva
`payment_information`	`PaymentInformation` Informações sobre transações de pagamento relacionadas à reserva.
`party_size`	`int64` Tamanho do grupo da reserva

BookingFailure

Dados de status que indicam a causa da falha assíncrona do processamento de uma reserva. O objetivo de BookingFailure é mostrar os erros de lógica de negócios.

Campos
`cause`	`Cause` Motivo da falha na reserva. (obrigatório)
`rejected_card_type`	`CreditCardType` (obrigatório apenas se a causa for PAYMENT_ERROR_CARD_TYPE_REJECTED)
`description`	`string` Esse campo é opcional e pode ser usado pelo parceiro para incluir informações adicionais a serem aplicadas na depuração. (opcional)
`payment_failure`	`PaymentFailureInformation` Informações sobre falhas de pagamento.

Causa

Enumeração das causas da falha.

Enums
`CAUSE_UNSPECIFIED`	Valor padrão: não usar, porque equivale a um "erro desconhecido"
`SLOT_UNAVAILABLE`	O horário referenciado não está mais disponível.
`SLOT_ALREADY_BOOKED_BY_USER`	O usuário já tem um agendamento para o horário disponível referenciado.
`LEASE_EXPIRED`	A locação (se definida) expirou e não pode mais ser usada para a reserva solicitada.
`OUTSIDE_CANCELLATION_WINDOW`	Não é possível realizar o cancelamento solicitado devido a restrições de tempo na política relacionada do comerciante.
`PAYMENT_ERROR_CARD_TYPE_REJECTED`	Ocorreu um erro ao processar o pagamento porque o tipo de cartão de crédito fornecido não foi aceito pelo comerciante. O tipo de cartão de crédito precisa ser definido em rejected_card_type.
`PAYMENT_ERROR_CARD_DECLINED`	Ocorreu um erro ao processar o pagamento porque o cartão de crédito fornecido foi recusado.
`PAYMENT_OPTION_NOT_VALID`	Ocorreu um erro relacionado ao pacote/assinatura usado para pagar a reserva. Talvez não seja mais possível usá-los ou tenham expirado.
`PAYMENT_ERROR`	Ocorreu um erro ao processar o pagamento desta reserva. Use esse valor para indicar uma falha geral relacionada ao pagamento somente se o erro não corresponder aos tipos mencionados acima.
`USER_CANNOT_USE_PAYMENT_OPTION`	O usuário não pode usar a opção de pagamento especificada (por exemplo, ele está tentando usar um preço de uso único pela segunda vez).
`BOOKING_ALREADY_CANCELLED`	O usuário está tentando cancelar uma reserva que já foi cancelada.
`BOOKING_NOT_CANCELLABLE`	O usuário está tentando cancelar uma reserva que não pode ser cancelada.
`OVERLAPPING_RESERVATION`	O usuário tem reserva com data muito próxima.
`USER_OVER_BOOKING_LIMIT`	Ocorreu uma falha na reserva porque a pessoa ultrapassou o limite de reservas por usuário do agregador.
`PAYMENT_REQUIRES_3DS1`	Defina esse campo quando você quiser que a transação seja efetuada novamente, mas depois de passar pelo desafio/resposta 3DS1. O estado de falha da transação atual permanecerá como "Failed". A nova tentativa será considerada uma transação diferente. Quando esse for o motivo da falha, o método payment_failure.3DS1_parameters PRECISARÁ ser definido. Se o motivo for outro, a causa atual será tratada como um PAYMENT_ERROR.

PaymentFailureInformation

Informações sobre falhas de pagamento.

Campos

Campos
`threeds1_parameters`	`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.

threeds1_parameters

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.

ThreeDS1Parameters

Parâmetros que solicitam que o RwG realize um desafio 3DS1.

São definidos pela descrição do protocolo 3DS1 pelo EMVCo.

Campos
`acs_url`	`string` O URL de onde carregar um formulário para apresentar ao usuário para autenticação.
`pa_req`	`string` Solicitação de PaymentAuthentication que será publicado no formulário ACSUrl, se informado.
`transaction_id`	`string` Identificador usado pelo provedor ACS. que será publicado no formulário ACSUrl, se informado.
`md_merchant_data`	`string` Dados do comerciante. que será publicado no formulário ACSUrl, se informado.

BookingStatus

Status de uma reserva

Enums
`BOOKING_STATUS_UNSPECIFIED`	Não especificado.
`CONFIRMED`	A reserva foi confirmada.
`PENDING_MERCHANT_CONFIRMATION`	O comerciante precisa confirmar a reserva para que o status mude para CONFIRMED (esse fluxo NÃO é compatível no momento).
`PENDING_CLIENT_CONFIRMATION`	O cliente precisa confirmar a reserva para que o status mude para CONFIRMED (esse fluxo NÃO é compatível no momento).
`CANCELED`	A reserva foi cancelada em nome do usuário.
`NO_SHOW`	O cliente não compareceu ao evento.
`NO_SHOW_PENALIZED`	O cliente não compareceu ao evento e violou a política de cancelamento.
`FAILED`	Não foi possível concluir a reserva devido a uma falha de processamento.
`DECLINED_BY_MERCHANT`	A reserva foi recusada de forma assíncrona pelo comerciante.

CallMerchant

Mensagem vazia a ser usada em SupportedPartySizeOption. Ao definir isso, vai aparecer uma opção para os usuários ligarem para a empresa e fazerem um agendamento.

CancellationPolicy

Política de cancelamento de um serviço.

Campos

Campos
`refund_condition[]`	`RefundCondition` Zero ou mais condições de reembolso aplicáveis à política.

refund_condition[]

RefundCondition

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

RefundCondition

Define uma única condição de reembolso. É possível usar várias condições juntas para criar etapas de reembolso relativas a períodos que antecedem o horário de início do serviço.

Campos

Campos
`min_duration_before_start_time`	`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.
`refund_percent`	`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.

min_duration_before_start_time

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.

refund_percent

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.

ClientInformation

Informações pessoais sobre a pessoa que fez a reserva

Campos
`given_name`	`string` Nome do cliente
`family_name`	`string` Sobrenome do cliente
`address`	`PostalAddress` Endereço do cliente
`telephone`	`string` Número de telefone do cliente
`email`	`string` Endereço de e-mail do cliente

CreateMerchantRequest

Solicitação para criar um Merchant.

Campos

Campos
`parent`	`string` O nome do recurso pai do parceiro que é proprietário do comerciante, no formato `partners/{partner_id}`.
`merchant_id`	`string` O ID a ser usado para este comerciante.
`merchant`	`Merchant` O comerciante a ser criado.

parent

string

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

merchant_id

string

O ID a ser usado para este comerciante.

merchant

Merchant

O comerciante a ser criado.

CreateServiceRequest

Solicitação para criar um novo Service.

Campos

Campos
`parent`	`string` O nome do recurso pai do comerciante proprietário do serviço, no formato `partners/{partner_id}/merchants/{merchant_id}`.
`service_id`	`string` O ID a ser usado para este serviço.
`service`	`Service` O serviço a ser criado.

parent

string

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

service_id

string

O ID a ser usado para este serviço.

service

Service

O serviço a ser criado.

CreditCardRestrictions

Restrições aos tipos de cartão de crédito aceitos pelo comerciante.

Campos

Campos
`credit_card_type[]`	`CreditCardType` Uma lista de cartões de crédito aceitos. Nenhum cartão de crédito será aceito se o campo estiver vazio.

credit_card_type[]

CreditCardType

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

CreditCardType

Tipo de cartão de crédito.

Enumerações
`CREDIT_CARD_TYPE_UNSPECIFIED`	Não utilizado.
`VISA`	Cartão de crédito Visa.
`MASTERCARD`	Cartão de crédito Mastercard.
`AMERICAN_EXPRESS`	Cartão de crédito American Express.
`DISCOVER`	Cartão de crédito Discover.
`JCB`	Cartão de crédito JCB.

DeleteMerchantRequest

Solicitação para excluir um Merchant.

Campos

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

name

string

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

DeleteServiceRequest

Solicitação para excluir um Service.

Campos

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

name

string

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

Depósito

Um depósito que pode ser cobrado ou gerar uma retenção no cartão de crédito do usuário.

Campos

Campos
`deposit`	`Price` Valor do depósito.
`min_advance_cancellation_sec`	`int64` Cancelamento mínimo antecipado do depósito.
`deposit_type`	`PriceType` Define como o depósito é determinado a partir da disponibilidade.

deposit

Valor do depósito.

min_advance_cancellation_sec

int64

Cancelamento mínimo antecipado do depósito.

deposit_type

PriceType

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

DirectMerchantPayment

Informações sobre como o usuário pode pagar diretamente ao comerciante em vez de pagar antecipadamente pelo serviço pelo RwG.

Campos

Campos
`payment_methods[]`	`Text` Recomendamos que os usuários paguem somente usando as formas de pagamento mencionadas abaixo.

payment_methods[]

Text

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

DurationRange

Wrapper para um intervalo de duração que pode ser limitado ou ilimitado. É obrigatório fornecer pelo menos as durações de min_duration e max_duration.

Campos

Campos
`min_duration`	`Duration` Duração mínima.
`max_duration`	`Duration` Duração máxima.

min_duration

Duração mínima.

max_duration

Duração máxima.

ExtendedServiceAvailability

Uma lista de disponibilidade e a quem/quando elas devem ser aplicadas.

Campos
`merchant_id`	`string` Este campo é obrigatório para especificar a qual comerciante as mensagens de disponibilidade abaixo pertencem.
`service_id`	`string` Este campo é obrigatório para especificar a qual serviço as mensagens de disponibilidade abaixo pertencem.
`start_time_restrict`	`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.
`end_time_restrict`	`Timestamp` Quando você define end_time_restrict, mas não start_time_restrict, todo o período até o end_time_restrict é considerado.
`duration_restrict`	`Duration` Definir a duração restringe ainda mais o escopo da atualização à disponibilidade com período correspondente.
`resources_restrict`	`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[]`	`Availability` A nova lista de disponibilidade.

FeedStatistics

Estatísticas recebidas durante o processamento de um feed enviado.

Campos

new_items

int64

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

existing_items

int64

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

deleted_items

int64

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

FeedStatus

Status de um feed enviado pela plataforma do agregador.

Campos
`name`	`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`	`State` Estado de processamento desse feed.
`error_details`	`string` String legível que vai fornecer mais detalhes se o feed não for processado.
`statistics`	`FeedStatistics` Estatísticas específicas deste feed.

Estado

Enumeração para indicar o estado de processamento de um feed.

Enums
`STATE_UNSPECIFIED`	Valor padrão. Não utilizado.
`IN_PROGRESS`	O feed ainda está sendo processado.
`SUCCESS`	O feed foi processado.
`FAILURE`	Encontramos um erro ao processar o feed.

FoodOrderingMetadata

Metadados para links de ação para pedidos de comida.

Campos
`fee_details[]`	`FeeDetails` Detalhes das taxas cobradas do usuário sobre o total do item. Repetida para diferentes tipos de taxas, como taxa de serviço, taxa de entrega etc.
`advance_order_details`	`AdvanceOrderDetails` Detalhes sobre o suporte avançado de pedidos, também conhecido como pedido antecipado, em que o usuário pode fazer um pedido para atendimento do pedido mais tarde.
Campo de união `fulfillment_duration_options`. Duração do tempo de atendimento do pedido a partir da confirmação. Para pedidos de entrega, o tempo até a entrega da comida. Para pedidos para retirada, o tempo até a comida estar pronta para retirada. `fulfillment_duration_options` pode ser apenas de um dos tipos a seguir:
`fulfillment_lead_time_duration`	`Duration` Duração fixa. Por exemplo: 30 minutos.
`fulfillment_lead_time_duration_range`	`DurationRange` Um intervalo de duração. Exemplos: * 30 a 45 min * Maior que 30 min * Menos de 50 min

AdvanceOrderDetails

Para suporte de pedidos antecipados.

Campos

is_supported

bool

Verdadeiro se Pedidos antecipados, também conhecidos como Pedido antecipado, forem compatíveis. (obrigatório)

FeeDetails

Detalhes da taxa.

Campos

type

FeeType

Tipo de taxa. (obrigatório)

fee_amount

FeeAmount

Valor da taxa em unidade de moeda, porcentagem do valor do carrinho ou uma combinação de ambos. (obrigatório)

FeeAmount

FeeAmount exemplos: * Taxa fixa: USD 0 (sem taxas), USD 1,5 * Faixa de taxa fixa: USD 1,0 (mínimo), USD 3,0 (máximo), USD 5 a 6,0 * Porcentagem do tamanho do carrinho: 15,5%, 10% a 20%, 10% (mínimo), 15% (máximo) * 2,5% do intervalo e porcentagem: USD 2,5

Campos
`cart_percentage`	`QuantitativeValue` Taxa em termos de porcentagem do valor do carrinho. Aceita um intervalo (limitado e ilimitado) ou uma porcentagem fixa. O valor deve estar entre 0 e 100. Exemplos: * Fixo 5,5% * Pelo menos 5,5% * No máximo 5,5% * 4,5% a 5,5%
Campo de união `amount_options`. Opções para especificar o valor monetário. `amount_options` pode ser apenas de um dos tipos a seguir:
`amount`	`Money` Valor fixo. Por exemplo, USD 3,5.
`amount_range`	`MoneyRange` Intervalo de valor. Exemplos: * US$ 3,5 a US$ 5,5 * No mínimo US$ 3,5 * No máximo US$ 5,5
`amount_unknown`	`bool` Valor desconhecido.

FeeType

Tipo de taxa.

Enums
`FEE_TYPE_UNSPECIFIED`	Tipo de taxa não especificado.
`DELIVERY`	Para taxas de entrega.
`SERVICE`	Para taxas de serviço.

FulfillmentOption

A opção de atendimento do pedido de um link de ação on-line para pedidos.

Campos
`fulfillment_type`	`FulfillmentType` Obrigatório. O tipo de fulfillment.
`available_day[]`	`AvailableDay` Obrigatório. Uma lista de dias em que há disponibilidade para esse método de atendimento (de preferência pelo menos dois).
`fee_details`	`FeeDetails` Obrigatório. Detalhes da taxa para o método de atendimento do pedido.
`minimum_order`	`Price` Obrigatório. Pedido mínimo para o método de atendimento de pedidos associado ao link de ação.

AvailableDay

Disponibilidade por dia.

Campos

fulfillment_date

Date

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

last_ordering_time

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

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

FeeDetails

Detalhes da taxa do método de atendimento de pedidos associado ao link de ação.

Campos
Campo de união `fee_details`. Modelo de taxa para o método de atendimento de pedidos. `fee_details` pode ser apenas de um dos tipos a seguir:
`no_fee`	`NoFee` Não há taxa para o método de atendimento do pedido.
`base_fee`	`MinimumFee` A taxa básica associada ao método de fulfillment.
`fixed_fee`	`FixedFee` A taxa fixa associada ao método de atendimento do pedido.

FixedFee

A taxa fixa necessária para o método de atendimento de pedidos associado ao link de ação.

Campos

amount

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

FulfillmentType

O tipo de fulfillment associado a um link de ação.

Enums
`FULFILLMENT_TYPE_UNSPECIFIED`	O tipo de fulfillment não foi especificado.
`FULFILLMENT_TYPE_DELIVERY`	O tipo de atendimento do pedido é entrega.
`FULFILLMENT_TYPE_PICKUP`	O tipo de atendimento do pedido é retirada.

MinimumFee

A taxa mínima necessária para o método de atendimento de pedidos associado ao link de ação.

Campos

base_fee_amount

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

NoFee

Nenhuma taxa é necessária para o método de atendimento de pedidos associado ao link de ação.

GenericDeleteRecord

Registro a ser excluído do tipo de feed mencionado na solicitação de URL.

Campos
`delete_time`	`Timestamp` Obrigatório. Esse carimbo de data/hora é usado para determinar a ordem em que uma exclusão será aplicada ao inventário.
Campo de união `record_type`. Encapsular diferentes tipos de feed (ndjson, baseado em proto etc.) O parceiro pode fornecer um registro completo, semelhante a como um registro é fornecido em um feed ou na API BatchPush. Os parceiros também têm a opção de incluir apenas os campos essenciais de um registro necessários para identificá-lo exclusivamente. `record_type` pode ser apenas de um dos tipos a seguir:
`data_record`	`bytes` Para feeds não baseados em proto.
`proto_record`	`Any` Para feeds baseados em proto.

GenericRecord

Registro do tipo de feed mencionado na solicitação de URL.

Campos
`generation_timestamp`	`Timestamp` Obrigatório. Esse carimbo de data/hora é usado para garantir a ordem correta das atualizações de inventário.
Campo de união `record_type`. Encapsular diferentes tipos de feed (ndjson, baseado em proto etc.) `record_type` pode ser apenas de um dos tipos a seguir:
`data_record`	`bytes` Para feeds não baseados em proto.
`proto_record`	`Any` Para feeds baseados em proto.

GeoCoordinates

Dados geográficos de um local, incluindo latitude, longitude e endereço.

Campos
`latitude`	`double` Latitude em graus. (opcional)
`longitude`	`double` Longitude em graus. (opcional)
Campo de união `addresses`. Endereço de um local (estruturado ou não estruturado). `addresses` pode ser apenas de um dos tipos a seguir:
`address`	`PostalAddress` Endereço postal do local, de preferência.
`unstructured_address`	`string` Um endereço não estruturado também pode ser usado. Por exemplo, "1600 amphitheatre parkway mountain view, ca 94043".

GetMerchantStatusRequest

A solicitação para receber um MerchantStatus.

Campos

name

string

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

GetStatusRequest

Solicitação para recuperar o Status de um feed específico enviado pela plataforma do agregador.

Campos

name

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}

HomeServiceData

É necessário fornecer outras informações sobre o setor de serviços domésticos.

Campos

category_type

string

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

job_type

string

O tipo de trabalho na categoria a que o serviço residencial pertence. Por exemplo, unclog_drain, install_faucet são os tipos de trabalho na categoria de encanador.

IntegrationType

Nível de integração suportada.

Enums
`INTEGRATION_TYPE_UNSPECIFIED`	O padrão é END_TO_END.
`INTEGRATION_TYPE_END_TO_END`	Integração ampla que permite reserva completa por meio do Google.
`INTEGRATION_TYPE_INVENTORY_ONLY`	O servidor de reserva não precisa oferecer esse serviço. Somente dados de comerciantes e serviços precisam ser enviados. Os dados de disponibilidade são opcionais.

InvalidateResourceRequest

Solicitação para invalidar um recurso.

Campos

resource_id

string

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.

LineItem

Um único item em um pedido: a reserva de um único serviço em um único horário.

Campos
`service_id`	`string` ID do serviço do comerciante.
`start_sec`	`int64` Início do horário disponível em segundos e no fuso UTC desde a época Unix.
`duration_sec`	`int64` Duração do horário disponível em segundos.
`tickets[]`	`OrderedTickets` Número de ingressos pedidos por tipo.
`price`	`Price` O preço total (excluindo tributos) deste item de linha.
`status`	`BookingStatus` Status do item de linha.

OrderedTickets

Número de ingressos pedidos por tipo.

Campos

ticket_id

string

ID de um tipo de tíquete.

count

int32

Número de ingressos pedidos para este tipo.

ListMerchantStatusesRequest

A solicitação para receber uma lista de MerchantStatus.

Campos
`parent`	`string` Obrigatório. O pai, que é proprietário dessa coleção de status de comerciante. Formato: `partners/{partner_id}/merchants`
`page_size`	`int32` Obrigatório. O número máximo de itens para retornar. É possível que o servidor reduza o tamanho da página.
`page_token`	`string` Opcional. O valor nextPageToken retornado de um ListMerchantStatusResponse anterior, se houver.
`booking_inventory_status_restrict`	`BookingInventoryStatus` Opcional. Restrição opcional para filtrar resultados por status de inventário de reserva.
`waitlist_inventory_status_restrict`	`WaitlistInventoryStatus` Opcional. Restrição opcional para filtrar os resultados por status do inventário na lista de espera.
`geo_match_restrict`	`GeoMatchingStatus` Opcional. Restrição opcional para filtrar resultados por status de correspondência geográfica.

BookingInventoryStatus

Status completo do inventário de reservas.

Enums
`BOOKING_INVENTORY_STATUS_UNSPECIFIED`	Não especificado.
`NO_VALID_FUTURE_INVENTORY`	O comerciante não tem inventário de reservas nos próximos 30 dias.
`HAS_VALID_FUTURE_INVENTORY`	O comerciante tem inventário de reservas nos próximos 30 dias.

GeoMatchingStatus

Status de correspondência geográfica do comerciante.

Enums
`GEO_MATCHING_STATUS_UNSPECIFIED`	Não especificado.
`GEO_UNMATCHED`	O comerciante não tem correspondência geográfica.
`GEO_MATCHED`	O comerciante tem correspondência geográfica.

WaitlistInventoryStatus

Status de todo o inventário da lista de espera.

Enums
`WAITLIST_INVENTORY_STATUS_UNSPECIFIED`	Não especificado.
`NO_VALID_WAITLIST_SERVICE`	O comerciante não tem uma lista de espera de suporte ao serviço.
`HAS_VALID_WAITLIST_SERVICE`	O comerciante tem uma lista de espera de suporte para serviços.

ListMerchantStatusesResponse

A resposta da lista MerchantStatus.

Campos

merchant_statuses[]

MerchantStatus

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

next_page_token

string

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

ListStatusRequest

A solicitação para recuperar o Status de vários feeds enviados pela plataforma do agregador.

Campos
`name`	`string` Nome do recurso do feed, no formato `partners/{partner_id}/feeds/merchants` `partners/{partner_id}/feeds/services` `partners/{partner_id}/feeds/availability`
`page_size`	`int32` O número máximo de itens para retornar.
`page_token`	`string` Valor next_page_token retornado de uma solicitação List anterior, se houver.
`state_restrict`	`State` Restrição opcional para filtrar os resultados por estado do feed.
`time_range_restrict`	`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.

ListStatusResponse

A solicitação para recuperar o Status de vários feeds enviados pela plataforma do agregador.

Campos

status[]

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.

next_page_token

string

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

LocalizedString

Instância de uma string em uma localidade.

Campos

locale

string

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

value

string

Mensagem na localidade acima (UTF-8).

Local

Informações geográficas sobre um local.

Campos
`place_id`	`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 IDs de lugar. Se esse valor for incluído, o Google corresponderá o local ao lugar relevante.
`name`	`string` Nome, telefone, URL e localização geográfica do local são usados para correspondê-lo com lugares no Google Maps. Este campo é opcional, mas pode ser necessário em alguns contextos. Por exemplo, um Service.location sem um nome não corresponde a uma entidade comercial, mesmo que eles estejam localizados no mesmo endereço. (opcional)
`telephone`	`string` Número de telefone público do local, incluindo os códigos de país e de área, por exemplo, +14567891234. (opcional)
`url`	`string` URL do site público do local. (opcional)
`geo`	`GeoCoordinates` Informações geográficas do local, incluindo latitude, longitude e endereço. (opcional)
`location_type`	`LocationType` O tipo do local, que precisa ser fornecido se ele for fornecido para um serviço.
`location_id`	`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 entrada personalizado, um conjunto de códigos 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)

LocationType

Tipo deste local.

Enums
`LOCATION_TYPE_UNSPECIFIED`	Tipo de local não especificado.
`VISITED_LOCATION`	Local visitado durante esse serviço.
`START_LOCATION`	Local de início do serviço. Também pode ser usado como MEETING_LOCATION.
`END_LOCATION`	Local de término do serviço.

Comerciante

Informações sobre um comerciante na plataforma do agregador.

Campos
`name`	`string` O nome do recurso do comerciante, no formato `partners/{partner_id}/merchants/{merchant_id}`.
`merchant_name`	`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.
`telephone`	`string` O número de telefone público do comerciante, incluindo o país e os códigos de área, por exemplo, +14567891234.
`url`	`string` O URL do site público do comerciante.
`geo`	`GeoCoordinates` Informações geográficas do comerciante, incluindo latitude, longitude e endereço.
`category`	`string` A categoria do negócio na plataforma do agregador.
`num_bookings_30d (deprecated)`	`int64` Este item está obsoleto. O uso desse campo está suspenso.
`tax_rate_basis_points (deprecated)`	`uint32` Este item está obsoleto. 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.
`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.
`payment_restrictions`	`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.
`payment_option[]`	`PaymentOption` Opções de pagamento disponíveis para esse comerciante. Os serviços dele poderão limitar cada opção de pagamento permitida.
`payment_processor_config (deprecated)`	`PaymentProcessorConfig` Este item está obsoleto. Configuração para um processador de pagamentos tokenizado, se o comerciante oferecer suporte a esse recurso.
`tokenization_config`	`TokenizationConfig` Configuração para um processador de pagamentos tokenizado, se o comerciante oferecer suporte a esse recurso.
`terms`	`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.
`brand_id`	`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.
`matching_hints`	`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)
`service_attribute[]`	`ServiceAttribute` Definições de qualquer atributo de serviço usado para descrever os serviços deste comerciante. (opcional)
`action_link[]`	`ActionLink` Opcional. URL de ação com idioma associado, lista de países restritos, tipo e plataforma opcional que indica em qual plataforma a ação deve ser realizada
`waitlist_advisement`	`Advisement` Opcional. Recomendações gerais de um comerciante específico para um usuário que está entrando em uma lista de espera pelo Reservar com o Google. Cada campo da instrução deve ter um limite de 100 bytes.

MerchantMatchingHints

Dicas para ajudar o Google a corresponder um comerciante a um lugar no Google Maps.

Campos

place_id

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 IDs de lugar.

MerchantStatus

Status de um comerciante na plataforma Reservar com o Google.

Campos
`name`	`string` O nome do recurso de status do comerciante, no formato `partners/{partner_id}/merchants/{merchant_id}/status`.
`merchant_name`	`string` Nome do comerciante fornecido pelos parceiros.
`input_geo_info`	`GeoCoordinates` Os parceiros forneceram informações geográficas do comerciante.
`processing_status`	`ProcessingStatus` Status de processamento do comerciante.
`booking_status`	`BookingStatus` Status relacionado à integração completa de reservas.
`waitlist_status`	`WaitlistStatus` Status relacionado à integração da lista de espera.
`geo_match`	`PlaceInfo` Lugar geográfico correspondente deste comerciante. Vai ser vazio se o comerciante não tiver correspondência geográfica.
`local_services_match`	`LocalServicesMatchInfo` Os anúncios do Serviços Locais são correspondentes a este comerciante. Vai ser vazio se não for um comerciante de serviços locais ou não corresponder a nenhum provedor.
`direct_urls[]`	`DirectUrl` Uma lista de URLs para demonstrar o conteúdo do inventário atual do comerciante. Isso não significa que o inventário está sendo veiculado, e o URL pode ser diferente dos que aparecem para o público.

BookingStatus

Status relacionado à integração completa de reservas.

Campos

has_valid_future_inventory

bool

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

DirectUrl

URL que aparece para o comerciante.

Campos

type

UrlType

Tipo desse URL.

url

string

URL que pode mostrar esse comerciante.

UrlType

Tipo do URL exibido.

Enums
`URL_TYPE_UNSPECIFIED`	Não especificado.
`BOOKING`	URL completo de reserva.
`WAITLIST`	URL completo da lista de espera.
`LOCAL_SERVICES`	URL dos Serviços Locais do Google.

LocalServicesMatchInfo

As informações dos serviços locais do Google coincidem (definidas apenas para o comerciante de serviços locais).

Campos

matched_providers[]

MatchedProvider

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

MatchedProvider

Provedor de serviços locais

Campos

customer_id

int64

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

categories[]

string

Categorias de serviços locais (indústrias). Por exemplo, "encanador" e "limpeza_de_carpete".

PlaceInfo

Informações de um lugar correspondente.

Campos

name

string

Nome do lugar.

formatted_address

string

Endereço formatado no idioma local.

place_id

string

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

ProcessingStatus

Status de processamento do comerciante.

Enums
`PROCESSING_STATUS_UNSPECIFIED`	Status não especificado.
`IN_PROGRESS`	O comerciante foi recebido pela Madden, mas ainda está sendo processado. Os comerciantes com esse status não terão outro status preenchido.
`COMPLETED`	Outros status do comerciante foram calculados.

WaitlistStatus

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

Campos

has_valid_waitlist_service

bool

Verdadeiro se o comerciante tiver serviço de lista de espera. Isso não garante que o comerciante seja realmente atendido.

MoneyRange

Wrapper para um intervalo de valor monetário que pode ser limitado ou ilimitado. É necessário incluir pelo menos min_amount ou max_amount.

Campos

min_amount

Money

Valor mínimo.

max_amount

Money

Valor máximo.

NoShowFee

Taxa a ser cobrada de um usuário se ele tiver feito uma reserva, mas não comparecer.

Campos

fee

Valor que pode ser cobrado do usuário se ele não comparecer no evento da reserva.

fee_type

PriceType

Define como a taxa é determinada a partir da disponibilidade.

Pedido

Pedido de agendamento de um serviço prestado pelo comerciante.

Campos
`name`	`string` Nome do recurso do pedido: `partners/{partner ID}/orders/{order ID}`
`client_information`	`ClientInformation` Informações pessoais do cliente que fez o pedido
`payment_information`	`PaymentInformation` Informações sobre transações de pagamento relacionadas ao pedido.
`merchant_id`	`string` ID do comerciante a que todos os serviços do pedido pertencem.
`item[]`	`LineItem` Itens de linha neste pedido.

OrderOnlineMetadata

Metadados para um link de ação de pedido on-line.

Campos

fulfillment_option[]

FulfillmentOption

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

PaymentInformation

Detalhes de pagamento relacionados a uma reserva

Campos

prepayment_status

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.

payment_transaction_id

string

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

PaymentOption

Opção que pode ser usada para pagar os serviços prestados por um comerciante. e pode ser compartilhada entre vários comerciantes (por exemplo, aqueles que fazem parte da mesma rede).

Campos
`payment_option_id`	`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.
`name`	`string` Nome da opção de pagamento. Pode ser visível para o usuário.
`description`	`string` Descrição da opção de pagamento, Pode ser visível para o usuário.
`price`	`Price` Preço da opção de pagamento.
`tax_rate`	`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.
`payment_option_type`	`PaymentOptionType` Tipo dessa opção de pagamento. Uso único para atendimentos sem hora marcada, várias utilizações para pacotes e ilimitado para assinaturas.
`session_count`	`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.
`purchase_interval`	`TimeRange` A opção de pagamento pode ser comprada dentro desse intervalo.
`valid_interval`	`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.
`valid_duration`	`Duration` Duração da validade da opção de pagamento (por exemplo, assinatura de 30 dias).
`activation_type`	`ActivationType` Define como a data de início da validade é determinada para essa opção de pagamento.
`user_restriction`	`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.

ActivationType

Define como a data de início da validade é determinada.

Enums
`ACTIVATION_TYPE_UNSPECIFIED`	Não utilizado.
`ACTIVATION_ON_PURCHASE`	A validade começa no momento da compra.
`ACTIVATION_ON_FIRST_USE`	A validade começa quando a opção de pagamento é usada pela primeira vez.

PaymentOptionType

Tipo de opção de pagamento.

Enums
`PAYMENT_OPTION_TYPE_UNSPECIFIED`	Não utilizado.
`PAYMENT_OPTION_SINGLE_USE`	A opção de pagamento só pode ser usada uma vez.
`PAYMENT_OPTION_MULTI_USE`	A opção de pagamento poderá ser usada se a contagem de sessões for > 0.
`PAYMENT_OPTION_UNLIMITED`	A opção de pagamento pode ser usada em um período válido. A contagem de sessões não é aplicável.

PaymentProcessorConfig

Configuração para um processador de pagamentos definida por comerciante.

Campos

processor

Processor

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

public_key

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

version

string

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

Processador

Define um parceiro específico de processador de pagamentos.

Enums
`PROCESSOR_UNSPECIFIED`	Não usado
`PROCESSOR_STRIPE`	Configuração para pagamentos com o Stripe.
`PROCESSOR_BRAINTREE`	Configuração para pagamentos com o Braintree.

PaymentRestrictions

Restrições às formas de pagamento aceitas pelo comerciante.

Campos

credit_card_restrictions

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.

PerOrderFee

Taxas a serem pagas uma vez por pedido, independentemente do número de ingressos.

Campos

delivery_fee

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

processing_fee

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

PerTicketFee

Taxas a serem pagas para cada ingresso comprado pelo usuário.

Campos

service_charge

Taxa extra avaliada por um serviço.

facility_fee

Taxa que é cobrada no local/instalação.

taxes

Tributos por ingresso.

PostalAddress

Endereço de um cliente ou empresa.

Campos
`address_country`	`string` O país, especificado usando o código ISO 3166-1 alfa-2, como "US" (obrigatório)
`address_locality`	`string` A localidade, por exemplo, "Mountain View". (obrigatório).
`address_region`	`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).
`postal_code`	`string` O código postal, por exemplo, "94043". (obrigatório).
`street_address`	`string` O endereço, por exemplo, "1600 Amphitheatre Pkwy". (obrigatório)

PrepaymentStatus

Status de pré-pagamento de uma reserva.

Enums
`PREPAYMENT_STATUS_UNSPECIFIED`	Se esse campo não for especificado, o padrão será PREPAYMENT_NOT_PROVIDED.
`PREPAYMENT_PROVIDED`	A taxa da reserva foi paga antecipadamente.
`PREPAYMENT_NOT_PROVIDED`	A taxa da reserva não foi paga antecipadamente.
`PREPAYMENT_REFUNDED`	A taxa era representada por PREPAYMENT_PROVIDED, mas foi reembolsada.

Preço

O preço de um serviço ou uma taxa.

Campos
`price_micros`	`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.
`currency_code`	`string` A moeda do preço definida no formato ISO 4217.
`pricing_option_tag`	`string` Uma string opcional e opaca que identifica a opção de preço associada ao preço estendido.

PriceInterpretation

Descreve como um preço deve ser interpretado e exibido para o usuário.

Enums
`PRICE_INTERPRETATION_UNSPECIFIED`	Quando a interpretação de preço não é especificada, o padrão é EXACT_AMOUNT.
`EXACT_AMOUNT`	Quando o preço deve ser interpretado como um valor específico. Exemplos: US$ 20 para aulas de ioga; US$ 15 para cortes de cabelo infantil.
`STARTS_AT`	Quando o preço de um serviço é variável, mas um preço mínimo é conhecido e exibido aos consumidores. Os consumidores podem fazer escolhas que aumentam o preço. Os serviços que usam essa priceInterpretation precisam utilizar o PrepaymentType NOT_SUPPORTED. Exemplos: a tosa de cães custa US$ 30,00, mas opções adicionais podem aumentar o preço.
`NOT_DISPLAYED`	Quando o preço de um serviço é variável. Portanto, nenhuma informação de preço é exibida de antemão aos consumidores. Os serviços que usam essa priceInterpretation precisam utilizar PrepaymentType NOT_SUPPORTED, e o preço deve ficar em branco. Exemplos: uma consultoria para um serviço doméstico.

PriceType

Define como o preço total é determinado com base na disponibilidade.

Enums

FIXED_RATE_DEFAULT

O preço é um valor fixo. Esse será o valor padrão se o campo não for definido.

Exemplos: depósito de US$ 50 para reservar uma mesa ou taxa de não comparecimento de US$ 20 para aulas de ioga.

PER_PERSON

O preço especificado é por pessoa, e o preço total é calculado de acordo com o tamanho do grupo especificado em Recursos como price_micros * party_size. Um preço PER_PERSON precisa ser acompanhado por um tamanho de grupo nos recursos de disponibilidade. Caso contrário, será considerada apenas uma pessoa.

Exemplos: R$ 10 para ingressos de um museu

QuantitativeValue

Wrapper para um valor numérico que pode ser um intervalo ou um valor fixo. Exemplos de QuantitativeValue: * Valor singular: value: 10.5 * Intervalo limitado: value_range {min_value: 5.5, max_value 10.5} * Limite inferior: value_range {min_value: 5.5} * Limite superior: value_range {max_value: 10.5}

Campos

Campo de união value_options. (obrigatório) value_options pode ser apenas de um dos seguintes tipos:

value

double

Um valor singular. Por exemplo: 5.6

value_range

RangeValue

Um intervalo de valores que também pode ser aberto ou limitado. Exemplos: * pelo menos 5,5 * No máximo 5,5 * 5,5 a 6,5

RangeValue

Intervalo de valores em que min_value < max_value. Requer pelo menos min_value ou max_value.

Campos

min_value

double

Valor mínimo.

max_value

double

Valor máximo.

Classificação

Define a classificação de uma entidade.

Campos

value

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.

number_of_ratings

uint64

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

RelatedMedia

Fotos relacionadas a este serviço. O Google rastreará essas mídias para garantir que elas sejam exibidas corretamente aos usuários finais. (opcional)

Campos
`url`	`string` URL desta fonte de mídia. O Google rastreará a mídia hospedada nesse URL.
`type`	`MediaType` Tipo dessa fonte de mídia.
`localized_caption`	`Text` Legenda da mídia compatível com i18n. Apenas texto simples é aceito. Todos os componentes HTML serão removidos. (opcional)
`attribution`	`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)
`caption (deprecated)`	`string` Este item está obsoleto. Obsoleto. Use localized_ caption.

Atribuição

Informações de atribuição para esta mídia.

Campos

localized_text

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

text
(deprecated)

string

Obsoleto. Use localized_text.

MediaType

Enumeração para indicar o tipo dessa fonte de mídia. Somente fotos são aceitas. Entre em contato com a equipe do Reservar com o Google se precisar de suporte para outras mídias.

Enums
`TYPE_UNSPECIFIED`	Não utilizado.
`PHOTO`	Indica que a mídia fornecida pelo URL é uma foto.

ReplaceServiceAvailabilityRequest

Solicitação para substituir a disponibilidade de um Service.

Campos

service_availability

ServiceAvailability

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

RequireCreditCard

Define se um cartão de crédito é necessário para agendar um horário.

Enums
`REQUIRE_CREDIT_CARD_UNSPECIFIED`	O requisito de cartão de crédito não está especificado de forma explícita, e o comportamento é idêntico ao especificado por CONDITIONAL.
`REQUIRE_CREDIT_CARD_CONDITIONAL`	O Google exigirá um cartão de crédito para a reserva se uma das seguintes condições for atendida: * a disponibilidade tem um preço, e o prepayment_type é definido como REQUIRED * o no_show_fee foi definido * o campo de depósito foi definido.
`REQUIRE_CREDIT_CARD_ALWAYS`	Um cartão de crédito é sempre necessário para reservar essa disponibilidade, independentemente de outros valores de campo.

Recursos

Um recurso é usado para diferenciar os espaços disponíveis quando diferentes membros da equipe ou salas fazem parte do serviço. É possível usar vários espaços e intervalos para o mesmo serviço quando eles têm recursos diferentes.

Campos
`staff_id`	`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.
`staff_name`	`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.
`room_id`	`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.
`room_name`	`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) Em um restaurante, o nome de um salão só deve ser usado para áreas de estar como o bar ou pátio e não deve ser usado para menus de preço fixo, atividades especiais ou qualquer outro valor que não seja de quarto (como reserva ou jantar). É altamente recomendável que a área de estar padrão não tenha uma sala associada a ela.
`party_size`	`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.

SchedulingRules

Regras de agendamento de um serviço.

Campos
`min_advance_online_canceling`	`int64` Aviso com antecedência mínima em segundos necessária para cancelar um agendamento on-line. (opcional)
`late_cancellation_fee (deprecated)`	`Price` Este item está obsoleto. Taxa para cancelamento feito dentro do período de aviso com antecedência mínima.
`noshow_fee (deprecated)`	`Price` Este item está obsoleto. Taxa de não comparecimento quando o cliente não cancelou a reserva.
`admission_policy`	`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)
`cancellation_policy`	`CancellationPolicy` Política de cancelamento das regras de agendamento. (obrigatório para parceiros da indústria de "Coisas legais para fazer")
Campo de união `min_booking_buffer`. Duração (em segundos) entre a última reserva e o horário de início ou término da disponibilidade. Se "min_advance_booking" estiver definido, o horário da última reserva será calculado como (<slot start time> - "min_advance_booking"). Se você preencher o "min_booking_buffer_before_end_time", o horário da última reserva será calculado como (<slot start time> - "min_advance_booking"). O valor de "min_booking_buffer_before_end_time" precisa ser positivo caso tenha sido especificado. Se nenhum dos dois forem definidos, será possível fazer um agendamento até o horário exato do início do evento. Se ambos os campos forem definidos, apenas um valor será escolhido, enquanto o outro valor será ignorado. Não é possível prever com precisão qual valor é escolhido. Exemplos: Um corte de cabelo que precisa ser agendado pelo menos uma hora antes do horário de início: 'scheduling_rules{ min_advance_booking: 3600 ...}` Um museu em que o último ingresso pode ser comprado 30 minutos antes do fechamento: 'scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}' Um ingresso de cinema que precisa ser comprado antes do horário de início da sessão: 'scheduling_rules{ ...}' (deixe esse campo em branco) (opcional). `min_booking_buffer` só pode ser um dos seguintes valores:
`min_advance_booking`	`int64` Duração (em segundos) entre a última reserva e o horário de início da disponibilidade.
`min_booking_buffer_before_end_time`	`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.

AdmissionPolicy

Política de admissão deste serviço.

Enums
`ADMISSION_POLICY_UNSPECIFIED`	Não utilizado.
`TIME_STRICT`	Os clientes precisam estar presentes no início do horário disponível, e o serviço é encerrado no horário de término dela. Exemplos de casos de uso de TIME_STRICT: * Um tour que começa às 9h e requer que todos os participantes cheguem no horário de início, e termina por volta das 12h. * Um agendamento de corte de cabelo às 15h no sábado que levará cerca de 30 minutos. * Uma aula de ginástica das 18h às 20h.
`TIME_FLEXIBLE`	Os clientes podem chegar a qualquer momento entre o início e o término do horário disponível para usar essa reserva. Exemplos de casos de uso de TIME_FLEXIBLE: * Um ingresso de museu que pode ser usado a qualquer momento na data da compra. * Um ingresso para um parque de diversões que pode ser utilizado das 12h às 21h.
`TIMED_ENTRY_WITH_FLEXIBLE_DURATION`	Os clientes precisam estar no local do comerciante no início do horário disponível, mas podem sair a qualquer momento. Por exemplo, no caso de um museu, um ingresso com hora marcada para as 10h exige que o usuário esteja no local nesse horário. O horário de início da disponibilidade deste serviço representa o horário de entrada designado. No entanto, o horário de término é usado apenas para identificar o horário de disponibilidade da reserva.

Serviço

Informações sobre um serviço fornecido pelo comerciante, por exemplo, corte de cabelo.

Campos
`name`	`string` O nome do recurso de serviço, no formato `partners/{partner_id}/merchants/{merchant_id}/services/{service_id}`.
`service_name`	`string` Nome do serviço, por exemplo, "corte de cabelo masculino". Obsoleto. Use localized_service_name.
`localized_service_name`	`Text` Nome do serviço, por exemplo, "corte de cabelo masculino". Possivelmente em várias localidades.
`description`	`string` Descrição do serviço exibida ao usuário. Obsoleto. Use localized_description.
`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 maravilhosa para o mar e a chance de brincar com a vida selvagem.</li> <li>Planos de viagem e serviços cuidadosamente projetados.</li> <li>Preço mais baixo garantido.</li> </ol> Apenas <li> crianças menores de <ul> ou <ol> tags. 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`	`Price` Preço do serviço.
`price_interpretation`	`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.
`rules`	`SchedulingRules` Regras para reservar/cancelar um horário.
`prepayment_type`	`PrepaymentType` Indica se um pré-pagamento é obrigatório, opcional ou não compatível.
`prepayment_terms`	`PrepaymentTerms` Termos relacionados à conclusão do pré-pagamento.
`form[] (deprecated)`	`ServiceIntakeForm` Este item está obsoleto. Obsoleto. Use intake_form e per_ticket_intake_form.
`intake_form`	`ServiceIntakeForm` Formulário que solicita informações adicionais do usuário quando ele reserva esse serviço. (opcional)
`per_ticket_intake_form`	`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)
`tax_rate`	`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.
`payment_option_id[]`	`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`	`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)
`no_show_fee`	`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)
`require_credit_card`	`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)
`action_link[]`	`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.
`type`	`ServiceType` Tipo predefinido desse serviço. (opcional)
`ticket_type[]`	`TicketType` Tipos de ingressos compatíveis que podem ser reservados/comprados para este serviço. (opcional)
`related_media[]`	`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)
`service_attribute_value_id[]`	`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)
`waitlist_rules`	`WaitlistRules` Regras para entrar na lista de espera.
`ticketing_vertical_specific_data`	`TicketingVerticalSpecificData` Informações adicionais exclusivas da indústria de ingressos para eventos. (opcional)
`integration_type`	`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.
`per_order_fee`	`PerOrderFee` Taxas no nível do pedido para a compra desse serviço. (opcional)
`tours_and_activities_content`	`ToursAndActivitiesContent` Campos de conteúdo específicos a tours e atividades.
`location[]`	`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`	`Rating` Avaliação de usuários para esse serviço como uma métrica agregada em todas as avaliações.
`home_service_data`	`HomeServiceData` Informações adicionais exclusivas do setor de serviços domésticos. (opcional)
`virtual_session`	`VirtualSession` Opcional. Informações sobre a sessão virtual. Ele é necessário para ativar serviços virtuais.
`direct_merchant_payment`	`DirectMerchantPayment` Opcional. Informações adicionais que precisarão ser adicionadas se o serviço exigir que o usuário pague diretamente ao comerciante. OBSERVAÇÃO IMPORTANTE: o RwG não está envolvido nesta transação. Ele será necessário se virtual_session estiver definido e o serviço não for sem custo financeiro ou prepayment_type NÃO estiver definido como REQUIRED.

PrepaymentTerms

Informações específicas sobre quando o pré-pagamento é concluído.

Campos

charge_timing

ChargeTiming

Quando a cobrança ocorrerá em relação ao tempo de compra.

charge_time_before_start_time_sec

int64

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

ChargeTiming

Enumeração para especificar quando a cobrança ocorrerá em relação ao horário da compra.

Enums
`CHARGE_TIMING_UNSPECIFIED`	Não utilizado.
`CHARGE_NOW`	O cliente vai ser cobrado imediatamente.
`CHARGE_LATER`	O cliente será cobrado mais tarde.

PrepaymentType

Enumeração para indicar o tipo de pré-pagamento.

Enums
`PREPAYMENT_TYPE_UNSPECIFIED`	Por padrão, supomos que o pré-pagamento é NOT_SUPPORTED.
`REQUIRED`	O usuário precisa pagar esse serviço no momento da reserva.
`OPTIONAL`	O usuário pode pagar durante o agendamento ou depois, mas o pré-pagamento não é uma condição para concluir a reserva.
`NOT_SUPPORTED`	Esse serviço não oferece pré-pagamento.

ServiceType

Tipos de serviço predefinidos.

Enums
`SERVICE_TYPE_UNSPECIFIED`	Não utilizado.
`SERVICE_TYPE_DINING_RESERVATION`	Reserva para refeições.
`SERVICE_TYPE_FOOD_ORDERING`	Pedido de comida, pode ser entrega ou para viagem, ou ambos.
`SERVICE_TYPE_FOOD_DELIVERY`	Entrega de comida.
`SERVICE_TYPE_FOOD_TAKEOUT`	Comida para viagem.
`SERVICE_TYPE_EVENT_TICKET`	Ingressos de eventos.
`SERVICE_TYPE_TRIP_TOUR`	Tours de passeios.
`SERVICE_TYPE_APPOINTMENT`	Serviço com opção de agendamentos ou aulas. Recomendado para (1) saúde e condicionamento físico, (2) spa e beleza, e (3) serviços de consultoria e avaliação financeira. Consulte os tipos compatíveis em https://developers.google.com/maps-booking/guides/end-to-end-integration/overview
`SERVICE_TYPE_ONLINE_APPOINTMENT`	Serviço que oferece agendamento on-line para uma aula ou sessão totalmente virtual. Precisa ser definido ao ativar agendamentos de serviços virtuais.
`SERVICE_TYPE_SHOPPING`	Serviço que permite que os usuários comprem do comerciante em questão. Pode ser entrega ou retirada.

ServiceAttribute

Os atributos de serviço são categorias definidas pelo parceiro que descrevem os serviços de um comerciante. Por exemplo, um banco pode definir um atributo de serviço "Tipo de conta" com os valores "Pessoal" e "Empresa", enquanto um salão de beleza, com os valores "Corte de cabelo", "Cor" e "Estilo".

Campos

attribute_id

string

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

attribute_name

string

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

value[]

Value

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

Valor

Representa um possível valor para um atributo de serviço específico.

Campos

value_id

string

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

value_name

string

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

ServiceAttributeValueId

Identifica um valor específico do atributo a ser aplicado a um serviço.

Campos

attribute_id

string

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

value_id

string

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

ServiceAvailability

Uma lista de disponibilidade e a quem/quando elas devem ser aplicadas.

Campos
`name`	`string` Nome do recurso do serviço a que esse valor será aplicado, no formato `partners/{partner_id}/merchants/{merchant_id}/services/{service_id}`
`start_time_restrict`	`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.
`end_time_restrict`	`Timestamp` Quando você define end_time_restrict, mas não start_time_restrict, todo o período até o end_time_restrict é considerado.
`duration_restrict`	`Duration` Definir a duração restringe ainda mais o escopo da atualização à disponibilidade com período correspondente.
`resources_restrict`	`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[]`	`Availability` A nova lista de disponibilidade.

ServiceIntakeForm

Define um formulário de entrada que personaliza o serviço de um comerciante.

Campos

field[]

ServiceIntakeFormField

Campos que serão exibidos ao usuário.

first_time_customers
(deprecated)

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.

returning_customers
(deprecated)

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.

ServiceIntakeFormField

Define um campo de um ServiceIntakeForm.

Campos
`id`	`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)
`type`	`FieldType` O tipo desse campo.
`label`	`string` Texto deste campo mostrado ao usuário. Obsoleto. Use `localized_label`.
`localized_label`	`Text` Texto deste campo mostrado ao usuário. O campo pode ser exibido para usuários de várias localidades. (obrigatório)
`value[]`	`string` Defina somente se o tipo de campo for LOCATION_SEARCH. Use o "location_id" no campo "location" para especificar o valor do local.
`choice_text[]`	`Text` Defina se, e somente se, o tipo de campo for MULTIPLE_CHOICE, CHECKBOXES ou DROPDOWN. Usado para enumerar as possíveis escolhas.
`is_required`	`bool` Indica se um usuário precisa responder a este campo.
`allow_custom_answer`	`bool` Indica se um valor personalizado é permitido além das respostas predefinidas. Isso só é aplicável quando o tipo de campo é LOCATION_SEARCH. (opcional)
`additional_option[]`	`Text` São fornecidas outras opções 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 é "Entrarei em contato com o fornecedor mais tarde". (opcional)
`ticket_type_restrict[]`	`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.
`hint`	`Text` O texto de dica para entrada, que aparece como um marcador de posição de texto. Isso só é aplicável quando o tipo de campo é SHORT_ANSWER ou PARAGRAPH. (opcional)

FieldType

Enumeração para indicar o tipo de campo.

Enums
`FIELD_TYPE_UNSPECIFIED`	Os campos de tipo não especificado ou desconhecido serão ignorados.
`SHORT_ANSWER`	Campo de texto de entrada de uma linha.
`PARAGRAPH`	Campo de texto de entrada de várias linhas.
`MULTIPLE_CHOICE`	Conjunto de botões de opção que requer a escolha de uma opção entre várias.
`CHECKBOXES`	Um ou mais itens enumerados com caixas de seleção.
`DROPDOWN`	Seleção em uma lista suspensa.
`BOOLEAN`	Botão sim/não.
`LOCATION_SEARCH`	Caixa de pesquisa que permite encontrar o local correspondente com base na entrada do usuário na lista fornecida.

TaxRate

Uma alíquota de impostos aplicada ao cobrar o usuário por um serviço e que pode ser definida por comerciante ou serviço.

Campos

micro_percent

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.

Termos

Um conjunto de regras e diretrizes exibidas ao usuário quando ele faz um agendamento pelo Reservar com o Google.

Campos

url

string

Opcionalmente, o URL para os Termos e Condições.

text

string

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

localized_text

Text

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

Texto

Payload de texto possivelmente localizado. Alguns campos de texto podem incluir conteúdo marcado.

Campos

value

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.

localized_value[]

LocalizedString

Valores de texto por localidade. Opcional.

TicketType

O TicketType é usado para diferenciar tíquetes com preços e/ou disponibilidades variados devido a diferentes tipos de usuário, atributos de serviço ou opções/complementos.

Um ingresso é a unidade mínima reservável para um serviço, por exemplo, um lugar em um passeio de rafting, uma entrada para um museu, um aluguel de caiaque duplo por um dia.

Campos
`ticket_type_id`	`string` O ID do tíquete é usado para diferenciar os diferentes tipos de ingresso do mesmo serviço e só precisa ser exclusivo.
`short_description`	`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.
`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`	`Price` Preço de um único ingresso desse tipo, sem tributos. A taxa de tributos do serviço é aplicada aos ingressos.
`per_ticket_fee`	`PerTicketFee` Taxas adicionais aplicadas à compra deste ingresso. (opcional)
`option_description`	`string` Descrição de opções adicionais para esse tipo de ingresso, se houver. Obsoleto. Use localized_option_description.
`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."

TicketingVerticalSpecificData

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

Campos
`event_category`	`EventCategory` Categoria do evento. Definido somente quando o evento se encaixa em uma das categorias predefinidas. (opcional)
`event_url`	`string` URL do evento no site do parceiro. (opcional)
`entity[]`	`Entity` Lista de entidades relacionadas ao evento. (opcional)
`event_attendance_mode`	`AttendanceMode` Obrigatório. O tipo de participação no evento.
`event_virtual_location_url[]`	`string` Opcional. URL em que o evento pode ser assistido.
`event_organizer`	`Text` Opcional. Organizador que organiza o evento.
`event_organizer_url`	`string` Opcional. URL do organizador que organiza o evento.
`event_organizer_type`	`OrganizerType` Opcional. O tipo de organizador.
`event_source_url[]`	`string` Obrigatório. URL das páginas em que as informações ou descrições do evento podem ser encontradas.
`event_state`	`EventState` Opcional. Estado do evento.

AttendanceMode

O tipo de participação no evento.

Enums
`ATTENDANCE_MODE_UNSPECIFIED`	Não especificado.
`ONLINE`	Para eventos virtuais.
`PHYSICAL`	Para eventos físicos.
`PHYSICAL_ONLINE_MIXED`	Para eventos físicos e virtuais.

Entidade

Representa uma entidade relacionada ao evento.

Campos
`id`	`string` Identificador exclusivo da entidade no banco de dados do parceiro. (opcional)
`name`	`string` Nome da entidade. (obrigatório)
`url`	`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)
`entity_type`	`EntityType` Tipo de entidade. (opcional)
`entity_role`	`EntityRole` Papel da entidade no evento. (opcional)
`public_identification_data`	`PublicIdentificationData` Referências públicas da entidade. (opcional)

EntityRole

Papel da entidade no evento.

Enums
`ENTITY_ROLE_UNSPECIFIED`	Não especificado.
`ENTITY_ROLE_HEADLINER`	A entidade representa a estrela ou o artista principal no evento.
`ENTITY_ROLE_SUPPORTER`	A entidade representa um artista secundário no evento.
`ENTITY_ROLE_HOME_TEAM`	A entidade representa a equipe da casa em um evento esportivo.
`ENTITY_ROLE_AWAY_TEAM`	A entidade representa a equipe visitante em um evento esportivo.

EntityType

Tipo de entidade. Observação: não é uma ontologia universal.

Enums
`ENTITY_TYPE_UNSPECIFIED`	Não especificado. Não use.
`ENTITY_TYPE_PERFORMER`	A entidade representa o artista ou grupo que se apresenta em um concerto ou show. Aplicável somente quando a categoria do evento é CONCERT ou THEATRE.
`ENTITY_TYPE_PLAYER`	A entidade representa a equipe esportiva ou o jogador no evento. Aplicável somente quando a categoria do evento é SPORTS.
`ENTITY_TYPE_CONCERT_TOUR`	A entidade representa o tour a que este evento pertence. Aplicável somente quando a categoria do evento é CONCERT.
`ENTITY_TYPE_SPORTS_SERIES`	A entidade representa um evento esportivo a que este evento pertence. Aplicável somente quando a categoria do evento é SPORTS.
`ENTITY_TYPE_PLAY`	A entidade representa o tipo de peça (por exemplo, musical, comédia, balé etc.) do evento. Aplicável somente quando a categoria do evento é THEATRE.

EventCategory

Subconjunto de categorias de evento usadas para personalizar a experiência do produto. Observação: não é uma ontologia universal de eventos.

Enums
`EVENT_CATEGORY_UNSPECIFIED`	Não especificado. Não use.
`EVENT_CATEGORY_CONCERT`	Shows.
`EVENT_CATEGORY_SPORTS`	Eventos esportivos.
`EVENT_CATEGORY_THEATRE`	Teatro.
`EVENT_CATEGORY_EXHIBITS`	Exposições.
`EVENT_CATEGORY_WORKSHOPS_AND_CLASSES`	Workshops e aulas.

EventState

Estado do evento.

Enums
`EVENT_STATE_UNSPECIFIED`	Não especificado.
`SCHEDULED`	O evento está programado.
`RESCHEDULED`	O evento foi remarcado.
`CANCELLED`	O evento foi cancelado.
`POSTPONED`	O evento foi adiado.

OrganizerType

O tipo de organizador.

Enums
`ORGANIZER_TYPE_UNSPECIFIED`	Não especificado.
`PERSON`	Para o organizador que é uma pessoa.
`ORGANIZATION`	Para o organizador que é uma organização.

PublicIdentificationData

Identificadores, páginas da Web ou qualquer outra fonte pública que faça referência a uma entidade.

Campos

relevant_url[]

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)

musicbrainz_id

string

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

TimeRange

Período em que a empresa está fechada, ou seja, [start_time, end_time].

Campos

start_time

O limite inferior do período.

end_time