Suporte completo de reservas

Perguntas frequentes

Veja a seguir perguntas que nossos parceiros fazem com frequência e as soluções deles.

Feeds

Os parceiros podem incluir comerciantes com mais de um local?
Sim, os parceiros podem fazer isso se adicionarem cada local separadamente no feed do comerciante.
Os horários podem se sobrepor?
Sim. Isso é possível porque os intervalos entre os horários não precisam ser iguais. Eles podem ser muito mais curtos do que a duração do serviço. Assim, você pode lidar com a lógica de negócios por conta própria. Por exemplo, pode haver um espaço único das 9h às 10h e outro das 9h15 às 10h15 para o mesmo serviço.
Ao usar a recorrência, os horários de exceção que estão lado a lado podem ser agregados?
Sim, eles podem ser combinados.
O que é exibido ao usuário quando min_advance_online_canceling está definido e quando não está?

As mensagens a seguir são mostradas ao usuário dependendo do valor de min_advance_online_canceling`:

  • Se for definido como um horário específico: "Se você fez um agendamento e não puder comparecer, cancele-o com <min_advance_online_canceling> de antecedência".
  • Se não for definido: "Caso você não possa comparecer no horário da sua reserva, ligue diretamente para <merchant> em <phone number> para perguntar sobre sua política de reembolso/cancelamento".

Servidor de agendamento

Um parceiro deve gerar o ID quando um novo agendamento na API Create Booking é chamado?
Sim, você precisa gerar um código de agendamento. Tratamos isso como um identificador opaco.

Atualizações de reservas em tempo real

Se o usuário tentar mudar o horário de início, a duração ou os serviços em uma reserva, essas alterações serão restringidas pelo feed de disponibilidade?
Sim. Por exemplo, um usuário não pode atualizar a reserva de 10h para 10h05, já que não há horários disponíveis no feed.
Se um parceiro excluir um comerciante ou serviço, isso causará a remoção de todos os serviços associados e espaços disponíveis associados?
Sim, se um parceiro excluir um comerciante ou serviço, os subníveis serão desativados automaticamente no nosso sistema.
A reserva UpdateBookingRequest contém a reserva inteira de CreateBookingResponse ou apenas os campos atualizados?
Ambos. Ele contém uma máscara com os campos atualizados e toda a reserva de CreateBookingResponse. Por exemplo, para um cancelamento de reserva, o objeto de reserva FieldMask Path="status" tem apenas Booking.status = 'BookingStatus.Canceled'.

Pagamentos

Quando o Google vai aceitar meu processador de pagamento preferido?
A lista mais recente de processadores compatíveis está disponível no site do Google Pay.
Para qualquer espaço disponível, uma empresa pode fornecer um preço diferente para cada membro da equipe que realiza o mesmo serviço?
Sim, você pode informar um preço de espaço conforme a disponibilidade e o membro da equipe, se disponibilizar diversas formas de pagamento no feed do comerciante. Consulte a mensagem PaymentOption para ver detalhes sobre o conjunto exato de campos que definem um payment_option.
Existe alguma dependência entre pré-pagamentos, depósitos e taxas de não comparecimento?
Não há dependência entre os pré-pagamentos, os depósitos e as taxas de não comparecimento especificadas no feed de serviço. É possível ter depósitos e taxas de não comparecimento válidas sem ativar os pré-pagamentos. No entanto, para que qualquer um desses três funcione corretamente, você precisa concluir sua integração de pagamentos.
Como as taxas fiscais são mostradas aos usuários?
Se uma alíquota for definida e o pagamento on-line for obrigatório, as tarifas fiscais serão mostradas separadas dos custos de serviço. Eles estão incluídos no preço total exibido ao usuário.

Ambientes de sandbox

Como posso acessar os links para o front-end do sandbox?
É possível acessar os links do sandbox na página Portal do parceiro > Inventário.
Existe um ambiente de sandbox onde os parceiros podem ver os dados e usá-los para fazer testes?
Sim, há um ambiente de sandbox para você executar testes completos de integração. Para mais informações, consulte nosso guia de teste completo.
Existe uma versão da API que acessa o ambiente do sandbox?
Sim, ative a versão de desenvolvimento da API Maps Booking no seu projeto do Google Cloud. Ela só pode ser acessada por usuários do Portal do parceiro que têm acesso automaticamente permitido. Depois de ativar, basta mudar o endpoint das chamadas de API para https://partnerdev-mapsbooking.googleapis.com/.
Qual é a diferença entre sandbox e produção?

O ambiente de sandbox é independente e permite testar mudanças sem afetar os sistemas de produção. A Central de ações oferece as seguintes partes do ambiente de sandbox:

Quando todos os componentes do ambiente de sandbox estão conectados a um ambiente de não produção nos seus sistemas (por exemplo, um ambiente de desenvolvimento ou preparação), é possível simular totalmente um ambiente de produção, sem afetar seus sistemas de produção. Observe as seguintes ressalvas:

  1. Conecte seus feeds de teste ou teste, o servidor de reserva e as APIs de atualização em tempo real ao ambiente do sandbox.
  2. Forneça um subconjunto de inventário real no seu ambiente de sandbox para fazer testes. Isso garante que todos os casos extremos do seu inventário sejam cobertos.
  3. Um servidor de reserva de sandbox nunca deve concluir solicitações de reserva ou atualizações em relação ao inventário ativo. Em vez disso, aponte o ambiente do sandbox para o de preparação ou teste.
  4. As reservas assíncronas precisam ser gerenciadas pela versão do sandbox das suas ferramentas do comerciante para aceitar/recusar reservas. Isso permitirá testar a atualização em tempo real de BookingNotification no sandbox.

Portal do parceiro

Visualização de inventário

Por que nenhum resultado é exibido após a aplicação dos filtros?
Verifique se há erros de digitação nos valores do filtro (por exemplo, espaços à direita). Além disso, se o inventário for excluído dos feeds, ele não vai aparecer nos resultados da pesquisa, a menos que o filtro Estado da integração = Deleted seja definido explicitamente.
Como classificar por estado do inventário?
Para adicionar um filtro de estado de inventário, primeiro adicione um filtro para o tipo de integração. Por exemplo, defina um filtro de tipo de integração como E2E (integração completa) e defina o filtro "Estado de inventário" como Live. Para mais informações sobre como definir filtros, consulte [aqui]/actions-center/partner-portal/inventory#applying_filters.

Terminologia

Os termos a seguir aparecem em todo o site.

agendamentos

Usado de maneira sinônimo de reservas. Um usuário reserva ou marca um horário em um determinado horário.

reservas

Um agendamento é a associação de um serviço oferecido por um comerciante por um bloco de tempo específico. Um usuário do Google pode criar um agendamento. Uma oferta de serviço pode ser uma aula de ginástica ou um corte de cabelo, por exemplo.

inventário

O conjunto de comerciantes, serviços e slots que você envia para a Central de ações.

leasings

A Central de ações solicita uma locação depois que um usuário seleciona um slot específico. A locação coloca uma retenção no slot para que nenhum outro usuário possa reservar esse horário específico até que ela expire ou que a reserva seja concluída. As leases são opcionais na v2 da API. Recomendamos o uso do CheckAvailabilty.

reservas

Uma reserva é provisória. Isso se aplica especificamente a restaurantes.

serviços

Os serviços são oferecidos pelos comerciantes. Um slot de serviço específico pode ser reservado por um usuário do Google.

slots

Um slot é uma instância específica de um serviço que está disponível para reserva. Pode haver vários slots para cada dia, e eles podem se sobrepor.

parceiros de agendamento

Um parceiro de programação envia dados de inventário ao Google. Enviamos dados do usuário quando um usuário faz um agendamento e você a realiza.

Diretrizes editoriais de conteúdo

Ao fornecer nomes e descrições de serviços, os envios precisam seguir três princípios:

  • Seja honesto e factual.
  • Descreva o serviço de forma clara e precisa.
  • Inclua informações relevantes e completas sobre os serviços para comerciantes com atributos.

Além disso, certifique-se de:

  • Use a ortografia e a gramática padrão.
  • Evite o uso repetido e desnecessário de pontuação, letras maiúsculas ou símbolos. Não use pontos de exclamação nos títulos dos seus serviços. O uso de símbolos, números e letras precisa estar de acordo com o verdadeiro significado do símbolo.
  • Evite repetições. Não é permitido postar palavras-chave excessivas, repetitivas ou irrelevantes.
  • Evite linguagem imprópria ou ofensiva.
  • Não coloque aspas duplas em torno do campo de descrição.
  • Não inclua caracteres irrelevantes, como asteriscos que não apontam para uma nota de rodapé. Se você precisar incluir uma nota de rodapé ou exoneração de responsabilidade, inclua-a como a última linha do atributo.
  • Inclua informações relevantes sobre as variantes nos serviços para que os clientes possam diferenciá-las.
  • Não inclua texto com erros de ortografia ou pontuação em nenhum campo.

Alertas do portal de parceiros

Consulte esta página para saber mais informações sobre os alertas do Portal de parceiros. Em cada seção há links para as próximas etapas apropriadas para seu problema.

Comerciantes sem disponibilidade

Um comerciante precisa ter uma ou mais disponibilidades futuras no feed de disponibilidade. Se não tiver pelo menos uma disponibilidade futura no feed de disponibilidade, o comerciante não poderá estar ativo na Central de ações. Consulte a tabela "Comerciantes sem disponibilidade futura" no painel Detalhes do inventário do Portal do parceiro para ver uma lista completa desses comerciantes. Essa tabela é atualizada a cada duas horas.

O comerciante não tem serviços

Um comerciante precisa ter um ou mais serviços no feed de serviços. Se não tiver pelo menos um serviço no feed de serviços, ele não poderá estar ativo na Central de ações. Consulte a tabela "Comerciantes ausentes" no painel Detalhes do inventário do Portal do parceiro para ver uma lista completa dos comerciantes. Essa tabela é atualizada a cada duas horas.

Comerciantes em um país onde não há suporte

O comerciante precisa estar em um país aceito pela sua implementação. Se o país do comerciante não for aceito pela Central de ações ou se sua implementação não for aceita, o comerciante não poderá estar ativo na Central de ações. Consulte a tabela "Total de comerciantes ativos por país" no painel Comerciantes ativos do Portal do parceiro para ver a lista completa de comerciantes por país. Essa tabela é atualizada a cada duas horas. Abra um caso no Portal do parceiro para ver quais países sua implementação é compatível atualmente ou quais comerciantes não estão ativos devido ao país em que estão.

Comerciantes que não têm um endereço completo

Para aparecer na Central de ações, o comerciante precisa corresponder a uma ficha no Google Maps. O endereço de um comerciante é um grande determinante para como o Google detecta qual comerciante acessa qual ficha do Google Maps. É altamente recomendável consultar regularmente a tabela "Comerciantes sem endereços completos" no Portal de parceiros para ter acesso à lista completa de comerciantes sem um endereço completo. Esses comerciantes não estão ativos na Central de ações. A tabela é atualizada a cada duas horas.

Comerciantes que não têm um número de telefone

Para aparecer na Central de ações, o comerciante precisa corresponder a uma ficha no Google Maps. O número de telefone de um comerciante determina como o Google detecta qual comerciante acessa cada ficha do Google Maps. Recomendamos incluir o número de telefone para aumentar as chances de o Google associar automaticamente os comerciantes a uma ficha do Google Maps. Consulte o feed de comerciantes para ver o formato adequado do número de telefone.

Serviços sem preço

Um serviço que tenha um custo adicional associado precisa incluir um preço válido. Se o preço do serviço não refletir um valor válido ou for US $0, 00, o serviço não poderá estar ativo na Central de ações. Consulte a tabela "Serviços sem preços" no painel Detalhes do inventário do Portal do parceiro para acessar a lista completa desses serviços. Essa tabela é atualizada a cada duas horas.

Serviços sem descrição

Um serviço precisa incluir uma descrição válida. Se a descrição do serviço estiver ausente, recomendamos que você a forneça. Isso dá detalhes importantes para os usuários que precisam saber o que estão reservando. Abra um caso no Portal do parceiro para receber uma lista de serviços sem descrição.

Como conseguir ajuda

Confira aqui as instruções para encontrar ajuda.

Novos parceiros

Se você quiser fazer a integração com a Central de ações, preencha este formulário de interesse.

Parceiros atuais

Enviar uma consulta ou reclamação

Se você é um parceiro da Central de ações e tem uma dúvida ou reclamação, crie um novo caso no Portal do parceiro para entrar em contato. No Portal de parceiros, acesse seu histórico de casos na página Ajuda e suporte > Casos. Para criar um novo caso, preencha a caixa "Como podemos ajudar?" e clique em "Iniciar" para acessar o novo formulário.

Ao criar um novo caso, faremos algumas perguntas para ajudarmos você da melhor forma. Responda a essas perguntas da melhor forma possível.

Depois de abrir um caso, você poderá ver e responder na sua caixa de entrada ou no Portal do parceiro. Você vai receber um e-mail sempre que houver uma atualização do seu caso. Depois que um caso for encerrado, você não poderá responder a ele novamente e terá que abrir um novo caso para futuras perguntas.

Qualquer pessoa a quem você conceder acesso à sua conta do Portal de parceiros (consulte o guia de contas e usuários sobre como gerenciar o acesso) poderá ver casos anteriores e responder a todos os abertos no Portal de parceiros. Cada caso tem um número que pode ser consultado a qualquer momento. Além disso, os e-mails que enviamos para você também podem ter um ID de referência associado a eles. Inclua o ID de referência ou outros identificadores (como o ID do comerciante) aplicáveis ao caso na sua consulta.

Acompanhar um caso

Se um caso que você enviou foi encerrado e você tem um acompanhamento a ele, é possível "reabri-lo" usando o botão Acompanhar um caso. Esse botão está localizado na parte superior do caso fechado ao acessá-lo na Ajuda do Portal de parceiros e na página Suporte > Casos.

O caso de acompanhamento aparecerá como um novo caso no Portal de parceiros depois que você clicar em "Enviar".