REST Resource: inventory.partners.merchants.services

string

O nome do recurso de serviço, no formato partners/{partner_id}/merchants/{merchantId}/services/{serviceId}.

string

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

object (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 localizedDescription.

object (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 recursos de uma viagem de cruzeiro:
<ol>
<li>Vista maravilhosa do oceano e chances de brincar com a vida selvagem.</li>
<li>Serviços e reservas de viagem cuidadosamente projetados.</li>
<li>Preço mais baixo garantido.</li>
</ol>
Apenas os <li> filhos das tags <ul> ou <ol> serão convertidos. 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> ...).
  URLs, âncoras e links serão removidos e nunca serão exibidos aos usuários finais. Se você quiser usar fotos para criar uma melhor experiência do usuário, envie os URLs de fotos usando o campo "relatedMedia" abaixo.
  

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.

object (Price)

O preço do serviço.

enum (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.

object (SchedulingRules)

Regras para reservar/cancelar um compromisso.

enum (PrepaymentType)

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

object (PrepaymentTerms)

Termos sobre quando o pré-pagamento é concluído.

object (ServiceIntakeForm)

Obsoleto. Use intakeForm e perTicketIntakeForm.

object (ServiceIntakeForm)

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

object (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)

object (TaxRate)

Taxa de tributos do serviço. Se presente, este campo modifica o taxRate definido no nível do comerciante. Quando você deixa a mensagem vazia (por exemplo, taxRate { }), a taxa de tributos aplicada passa a ser zero.

string

Lista de códigos que fazem referência às opções de pagamento e 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.

object (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)

object (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)

enum (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)

object (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.

enum (ServiceType)

Tipo predefinido desse serviço. (opcional)

object (TicketType)

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

object (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)

object (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)

object (WaitlistRules)

Regras para participar da lista de espera.

object (TicketingVerticalSpecificData)

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

enum (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.

object (PerOrderFee)

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

object (ToursAndActivitiesContent)

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

object (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.

object (Rating)

Classificação do usuário para esse serviço como uma métrica agregada em todas as avaliações.

object (HomeServiceData)

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

object (VirtualSession)

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

object (DirectMerchantPayment)

Opcional. Informações adicionais que precisam ser adicionadas se o serviço exigir que o usuário pague diretamente ao comerciante. OBSERVAÇÃO IMPORTANTE: a RwG não está envolvida nessa transação. É necessário se virtualSession estiver definido e o serviço não for sem custo financeiro ou se prepaymentType não estiver definido como REQUIRED.

object (UriTemplate)

Opcional. Um modelo opcional que especifica como o Google deve gerar URLs para sites externos.

string (int64 format)

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

object (Price)

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

object (Price)

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

enum (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)

object (CancellationPolicy)

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

string (int64 format)

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

string (int64 format)

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

object (RefundCondition)

Condições de reembolso podem ou não ser aplicáveis à política.

string (Duration format)

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

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

integer (uint32 format)

Porcentagem que pode ser reembolsada, desde que a reserva seja cancelada pelo menos minDurationBeforeStartTime 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 o valor integral pode ser reembolsado.

enum (ChargeTiming)

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

string (int64 format)

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

object (ServiceIntakeFormField)

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

boolean

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.

boolean

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)

enum (FieldType)

O tipo deste campo.

string

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

object (Text)

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

string

Defina se e somente se o tipo de campo for LOCATION_SEARCH. Use o "locationId" no campo "location" para especificar o valor do local.

object (Text)

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

boolean

Indica se a resposta a este campo é obrigatória para o usuário.

boolean

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

object (Text)

Opções adicionais além dos valores fornecidos. Aplicável somente quando o tipo de campo é LOCATION_SEARCH. Por exemplo, além da lista de locais fornecida, outra opção disponível pode ser "Vou 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.

object (Text)

O texto de sugestão 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)

string

O código é usado para diferenciar os vários tipos de ingresso do mesmo serviço. Portanto, deve 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 localizedShortDescription.

object (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.

object (Price)

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

object (PerTicketFee)

Taxas adicionais aplicadas à compra deste ingresso. (opcional)

enum (PriceDisplayType)

Opcional. Tipo de exibição de preço predefinido de um único ingresso desse tipo.

string

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

object (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: para um ingresso de admissão com diferentes tipos, como "adulto" ou "criança", e cujo idioma é uma opção adicional, a lista de TicketType seria: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "child" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "child" } localizedOptionDescription { value: "spanish" } }

Exemplo 2: para um aluguel de caiaque de várias horas com complemento opcional de bolsa impermeável, a shortDescription poderia ser "3 horas", e a optionDescription, "com bolsa impermeável" ou "sem bolsa impermeável": - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "3 hours" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "3 hours" } localizedOptionDescription { 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 optionDescription 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."

enum (InventoryType)

Opcional. Tipo de inventário predeterminado de um único ingresso desse tipo.

object (Price)

Taxa extra para um serviço.

object (Price)

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

object (Price)

Tributos por ingresso.

string

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

enum (MediaType)

Tipo dessa fonte de mídia.

object (Text)

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

object (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 localizedCaption.

object (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 localizedText.

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 valueId na definição do atributo do serviço.

integer

Obrigatório. Precisa ser um número inteiro positivo para serviços que têm lista de espera. Se o serviço ou o comerciante não tiver uma lista de espera, esse valor não poderá ser preenchido.

integer

Obrigatório. Precisa ser um número inteiro positivo para serviços que têm lista de espera. Se o serviço ou o comerciante não tiver uma lista de espera, esse valor não poderá ser preenchido.

boolean

Se esse campo for verdadeiro, o usuário poderá enviar um texto de formato livre ao entrar na lista de espera desse serviço.

object (UnsupportedPartySizeOption)

Define opções para partes maiores que o maxPartySize definido. Deixe em branco se grupos maiores não puderem ter opções alternativas para entrar em uma lista de espera.

object (CallMerchant)

Grupos fora do intervalo podem ligar para a empresa. Uma mensagem predefinida será exibida para o usuário. Exemplo de texto a ser exibido: "Para grupos maiores que {waitlistRules.max_party_size}, ligue para o restaurante no número {phone}." CallMerchant precisa ser definido, mas vai estar vazio.

enum (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)

object (Entity)

Lista de entidades relacionadas ao evento. (opcional)

enum (AttendanceMode)

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

string

Opcional. URL em que o evento pode ser assistido.

object (Text)

Opcional. Organizador que hospeda o evento.

string

Opcional. URL do organizador que hospeda o evento.

enum (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.

enum (EventState)

Opcional. Estado do evento.

object (Text)

Opcional. O nome da marca localizado.

object (EventCreator)

Opcional. Informações sobre o criador 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 claramente a entidade. É a página da Web referente à entidade no site do parceiro, se houver. Para outros URLs públicos da entidade, use relevantUrl em publicIdentificationData. (opcional)

enum (EntityType)

Tipo de entidade. (opcional)

enum (EntityRole)

Papel da entidade no evento. (opcional)

object (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)

string

Opcional. Nome do criador do evento. Sem restrição de caracteres.

object (Price)

Taxa que pode variar de acordo com o método de exibição.

object (Price)

Taxa para processar a forma de pagamento do usuário.