Suporte completo para agendamentos

Perguntas frequentes

Confira a seguir as perguntas mais frequentes dos nossos parceiros e as soluções.

Feeds

Os parceiros podem incluir comerciantes com mais de um local?
Sim, isso pode ser feito se os parceiros 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, isso pode ser feito.
O que é exibido ao usuário quando min_advance_online_canceling está definido e quando não está?

As mensagens a seguir são exibidas para o usuário dependendo do valor de "min_advance_online_canceling":

  • Se definido para um horário específico: "Se você fez uma reserva e não puder comparecer, cancele com <min_advance_online_canceling> de antecedência".
  • Se não estiver definido: "Caso você não possa comparecer no horário agendado, fale com <merchant> pelo telefone <phone number> para perguntar sobre a política de reembolso/cancelamento".

Servidor de agendamento

Um parceiro precisa gerar o ID de reserva quando um novo agendamento na API CreateBooking é chamado?
Sim, você precisa gerar um código de agendamento. Ele é considerado um identificador opaco.

Atualizações de agendamento 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.
O agendamento UpdateBookingRequest contém toda a reserva de CreateBookingResponse ou apenas os campos atualizados?
Ambos. Ele apresenta uma máscara que contém os campos atualizados e toda a reserva de CreateBookingResponse. Por exemplo, para cancelar, o objeto de agendamento 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 a integração de pagamentos.
Como as taxas de impostos são mostradas aos usuários?
Se houver uma alíquota de impostos e o pagamento on-line for obrigatório, os tributos serão mostrados separadamente dos custos do 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 Google Partners > 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 testes 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 Google Partners que têm acesso automático. 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. O Centro 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 não de produção nos seus sistemas (por exemplo, um ambiente de desenvolvimento ou de teste), é possível simular totalmente um ambiente de produção sem afetar os sistemas de produção. Observe as seguintes ressalvas:

  1. Conecte seus feeds de teste ou de preparação, o servidor de reservas e as APIs de atualização em tempo real ao ambiente do sandbox.
  2. Forneça um subconjunto de inventário do mundo real no seu ambiente de sandbox para testar. Isso garante que todos os casos extremos com seu inventário sejam cobertos.
  3. Um servidor de reserva do sandbox nunca deve concluir solicitações de reserva ou atualizações no inventário em tempo real. Em vez disso, aponte o ambiente de sandbox para o ambiente de teste ou de pré-produção.
  4. Os agendamentos assíncronos precisam ser gerenciados pela versão de sandbox das suas ferramentas de comerciante para aceitar/recusar agendamentos. Isso permite testar a atualização em tempo real da BookingNotification no sandbox.

Portal do parceiro

Visualização de inventário

Por que não há resultados mostrados após a aplicação de filtros?
Verifique se há erros de digitação nos valores do filtro, como 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 "Integration State = Deleted" seja definido explicitamente.
Como faço para classificar por estado do inventário?
Para adicionar um filtro de estado do 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 de estado do 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 como sinônimo de reservas. Um usuário reserva ou marca um horário específico.

reservas

Um agendamento é a associação de um serviço oferecido por um comerciante por um período 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 o Actions Center.

aluguéis

O Actions Center solicita um contrato de locação depois que um usuário seleciona um slot específico. A locação reserva o horário para que nenhum outro usuário possa agendar esse horário até que a locação expire ou a reserva seja concluída. As alocações são opcionais na v2 da API, e recomendamos o uso do CheckAvailabilty.

reservas

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

serviços

Os serviços são oferecidos pelos comerciantes. Um determinado horário de serviço pode ser reservado por um usuário do Google.

slots

Um slot é uma instância específica de um serviço disponível para agendamento. É possível ter vários horários 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 uma reserva e você realiza a reserva.

Diretrizes editoriais de conteúdo

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

  • Seja honesto e objetivo.
  • Descreva o serviço de forma clara e precisa.
  • Inclua informações relevantes e completas sobre os serviços do comerciante com atributos.

Além disso, confira se você:

  • 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 serviços. O uso de símbolos, números e letras precisa obedecer ao significado real do símbolo.
  • Evite repetições. Não é permitido postar palavras-chave excessivas, repetitivas ou irrelevantes.
  • Evite linguagem ofensiva ou imprópria.
  • Não inclua aspas duplas em torno do campo de descrição.
  • Não inclua caracteres irrelevantes, como asteriscos que não direcionam para uma nota de rodapé. Se você precisar incluir uma nota de rodapé ou aviso legal, inclua essa informação 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 sobre os alertas do portal de parceiros. Há links para as próximas etapas adequadas para seu problema incluídos em cada seção.

Disponibilidade ausente dos comerciantes

Um comerciante precisa ter uma ou mais disponibilidades futuras no feed de disponibilidade. Se o comerciante não tiver pelo menos uma disponibilidade futura no feed de disponibilidade, ele não poderá ser publicado no Centro de ações. Consulte a tabela "Merchants Missing Future Availability" no painel Inventory Details do Portal do Google Partners para ver uma lista completa desses comerciantes. Essa tabela é atualizada a cada duas horas.

Serviços ausentes do comerciante

O comerciante precisa ter um ou mais serviços no feed de serviços. Se o comerciante não tiver pelo menos um serviço no feed de serviços, ele não poderá ser publicado no Centro de ações. Consulte a tabela "Merchants Missing Services" no painel Inventory Details do Portal do Google Partners para conferir uma lista completa desses comerciantes. Essa tabela é atualizada a cada duas horas.

Comerciantes em um país sem suporte

O comerciante precisa estar em um país com suporte para sua implementação. Se o país do comerciante não for aceito pelo Actions Center ou se a implementação não for compatível com esse país, o comerciante não poderá ser ativado no Actions Center. Consulte a tabela "Total de comerciantes ativos por país" no painel Comerciantes ativos do Portal do Google Partners para conferir a lista completa de comerciantes por país. Essa tabela é atualizada a cada duas horas. Abra um caso no Portal do parceiro para saber quais países sua implementação oferece suporte ou quais comerciantes não estão ativos devido ao país em que estão.

Comerciantes sem um endereço completo

Para ativar o Centro de ações, um comerciante precisa ser associado a uma listagem no Google Maps. O endereço de um comerciante é um grande determinante para o Google detectar qual comerciante vai para qual ficha do Google Maps. É altamente recomendado consultar regularmente a tabela "Merchants Without Complete Addresses" no Portal do Google Partners para conferir a lista completa de comerciantes sem um endereço completo. Esses comerciantes não estão no Centro de Ações. A tabela é atualizada a cada duas horas.

Comerciantes sem número de telefone

Para ativar o Centro de ações, um comerciante precisa ser associado a uma listagem no Google Maps. O número de telefone de um comerciante é um determinante de como o Google detecta qual comerciante vai para qual listagem do Google Maps. É altamente recomendável incluir o número de telefone para aumentar as chances de o Google associar automaticamente seus comerciantes a uma listagem do Google Maps. Consulte o feed de comerciantes para conferir o formato correto do número de telefone.

Serviços sem preço

Um serviço que tem um custo extra associado precisa incluir um preço válido. Se o preço do serviço não for válido ou for $0, 00, ele não poderá ser ativado no Centro de ações. Consulte a tabela "Serviços sem preços" no painel Detalhes do inventário do Portal do Google Partners para conferir uma 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ê forneça uma. Isso permite que os usuários tenham acesso a detalhes importantes sobre o que estão reservando. Abra um caso no Portal do Google Partners para receber uma lista de serviços que não têm descrição.

Como conseguir ajuda

Confira as instruções para encontrar ajuda.

Novos parceiros

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

Parceiros atuais

Como enviar uma consulta ou reclamação

Se você já é parceiro do Actions Center e tem uma pergunta ou reclamação, crie um novo caso no Portal do Parceiro para entrar em contato com nossa equipe. No Portal do parceiro, acesse o 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 formulário do novo caso.

Ao criar um novo caso, você vai responder a algumas perguntas para que possamos ajudar você. Responda a estas perguntas da melhor forma possível.

Depois de abrir um caso, você poderá conferir e responder por e-mail ou no Portal do parceiro. Você vai receber um e-mail sempre que houver uma atualização no seu caso. Quando um caso é fechado, não é possível responder a ele novamente. Se você tiver dúvidas no futuro, será necessário abrir um novo caso.

Qualquer pessoa que você conceder acesso à sua conta do Portal do parceiro (consulte o guia "Contas e usuários" para saber como gerenciar o acesso) poderá acessar os casos anteriores e responder a qualquer caso aberto no Portal do parceiro. Cada caso terá um número de caso que você poderá consultar a qualquer momento. Além disso, os e-mails que enviamos a você também podem ter um ID de referência associado. Inclua esse ID de referência ou qualquer outro identificador (como um ID do comerciante) que seja relevante para o caso na sua consulta.

Acompanhamento de um caso

Se um caso que você enviou foi encerrado e você tem um acompanhamento sobre ele, é possível reabrir o caso usando o botão "Acompanhar um caso". Esse botão fica na parte de cima do caso fechado quando você o acessa na página de ajuda do Portal do parceiro e Suporte > Casos.

O caso de acompanhamento vai aparecer como um novo caso no Portal do parceiro depois que você clicar em "Enviar".

Solicitação de dados da empresa

Para iniciar uma nova solicitação de dados da empresa que ainda não estão disponíveis nos relatórios da Central de ações, entre em contato pelo formulário de solicitação de acesso a dados de usuários comerciais.