Perguntas frequentes
Veja a seguir as perguntas que nossos parceiros fazem com frequência, bem como 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 definido como um horário específico: "Se você fez uma reserva e não pode comparecer, cancele sua reserva com <
min_advance_online_canceling
> de antecedência." - Se a opção não for definida: "Caso você não possa comparecer no horário agendado, ligue diretamente para <
merchant
> no número <phone number
> para perguntar sobre a política de reembolso/cancelamento."
Servidor de agendamento
- Um parceiro precisa gerar o código quando um novo agendamento na API Create Booking é 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 automaticamente desativados no sistema.
- O agendamento com
UpdateBookingRequest
contém todo o agendamento deCreateBookingResponse
ou apenas os campos atualizados? - Ambos. Ele contém uma máscara que contém os campos atualizados e a reserva completa de
CreateBookingResponse
. Por exemplo, para um cancelamento, o objeto de reservaFieldMask Path="status"
tem apenasBooking.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 umpayment_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 exibidas aos usuários?
- Se uma alíquota for definida e o pagamento on-line for necessário, as tarifas tributárias serão mostradas separadamente dos custos do serviço. Elas estão incluídas no preço total mostrado 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 de parceiros > 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 de parceiros com acesso permitido automaticamente. 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 é um ambiente independente que permite testar alterações sem afetar os sistemas de produção. A Central de ações oferece as seguintes partes do ambiente do sandbox:
- Caixas de depósito do feed de sandbox
- Configuração do servidor de agendamento de sandbox
- Endpoints RTU de sandbox
- Ambiente de sandbox do Portal do parceiro
- Front-end do produto 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 de preparação), é possível simular totalmente um ambiente de produção, sem afetar os sistemas de produção. Observe as seguintes ressalvas:
- Conecte seus feeds de teste ou preparo, o servidor de agendamento e as APIs de atualização em tempo real ao ambiente de sandbox.
- Forneça um subconjunto de inventário do mundo real no ambiente do sandbox para fazer testes. Isso garante que todos os casos extremos do inventário sejam cobertos.
- Um servidor de agendamento com sandbox nunca deve concluir solicitações de reserva ou atualizações no inventário ativo. Em vez disso, aponte o ambiente do sandbox para seu ambiente de preparo ou teste.
- 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 do BookingNotification no sandbox.
Portal do parceiro
Visualização do inventário
- Por que não são exibidos resultados após a aplicação de 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 de estado de integração =
Deleted
seja definido explicitamente. - Como 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 comoLive
. 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 agenda ou marca um horário para um determinado horário.
reservas
Uma reserva é 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ços pode ser uma aula de condicionamento físico 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.
arrendamentos
A Central de ações solicita uma concessão depois que um usuário seleciona um slot específico. O lease estabelece uma retenção para que nenhum outro usuário possa reservar um horário específico até que o lease 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. Isso se aplica especificamente a refeições.
serviços
Os serviços são oferecidos pelas lojas. 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 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 ele faz uma reserva e você a realiza.
Diretrizes editoriais de conteúdo
Ao fornecer nomes e descrições de serviços, seus 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 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 publicar palavras-chave excessivas, repetitivas ou irrelevantes.
- Evite linguagem imprópria ou ofensiva.
- Não inclua aspas duplas em torno do campo de descrição.
- Não inclua caracteres irrelevantes, como asteriscos que não apontem para uma nota de rodapé. Se você precisar incluir uma nota de rodapé ou exoneração de responsabilidade, inclua-a na última linha do atributo.
- Inclua informações relevantes das variantes nos serviços para permitir que os clientes as diferenciem.
- 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. Há links para as próximas etapas apropriadas para seu problema incluídos em cada seção.
Comerciantes sem disponibilidade
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á estar ativo na Central de ações. Consulte a tabela "Comerciantes que ainda não têm disponibilidade futura" no painel Detalhes do inventário do Portal de parceiros para ver uma lista completa desses comerciantes. Essa tabela é atualizada a cada duas horas.
Comerciante sem serviços
Um 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á estar ativo na Central de ações. Consulte a tabela "Comerciantes com serviços ausentes" no painel Detalhes do inventário do Portal de parceiros para ver uma lista completa desses comerciantes. Esta tabela é atualizada a cada duas horas.
Comerciantes em um país não aceito
O comerciante precisa estar em um país em que a implementação está disponível. Se o país do comerciante não estiver disponível na Central de ações ou se a sua implementação não for compatível, 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 de parceiros para saber em quais países sua implementação está disponível ou quais comerciantes não estão ativos por causa do país em que estão.
Comerciantes sem um endereço completo
Para estar ativo na Central de ações, um comerciante precisa corresponder a uma ficha no Google Maps. O endereço de um comerciante é um grande determinante de como o Google detecta qual comerciante vai para cada ficha do Google Maps. É altamente recomendável consultar regularmente a tabela "Comerciantes sem endereços completos" no Portal de parceiros para ver a 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 sem número de telefone
Para estar ativo na Central de ações, um comerciante precisa corresponder a uma ficha no Google Maps. O número de telefone de um comerciante é determinante para como o Google detecta qual comerciante vai até cada ficha do Google Maps. Recomendamos que você inclua o número de telefone para aumentar as chances de o Google fazer a correspondência automática dos seus comerciantes com 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 com 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, ele 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 ver uma lista completa desses serviços. Esta 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 dá detalhes importantes aos usuários que precisam saber o que estão reservando. Abra um caso no Portal do parceiro para receber uma lista de serviços que não têm uma descrição.
Como conseguir ajuda
Confira as instruções para encontrar ajuda.
Novos parceiros
Para integrar com a Central de ações, preencha este formulário de interesse.
Parceiros atuais
Registrar uma consulta ou reclamação
Se você já for parceiro da Central de ações e tiver uma dúvida ou reclamação, crie um novo caso no Portal de parceiros para entrar em contato com nossa equipe. No Portal de parceiros, você pode acessar 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 formulário de novo caso.
Ao criar um novo caso, você precisará responder a algumas perguntas para que possamos ajudar da melhor forma possível. Responda a essas perguntas da melhor forma possível.
Depois de abrir um caso, você poderá acessar e responder na sua caixa de entrada ou no Portal de parceiros. Você receberá um e-mail sempre que houver uma atualização sobre seu caso. Depois que um caso for encerrado, você não poderá mais responder a ele, e será necessário abrir um novo para perguntas futuras.
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 os casos anteriores e responder a todos os casos abertos no Portal de parceiros. Cada caso terá um número que pode ser referenciado a qualquer momento. Além disso, os e-mails que enviamos a você também podem ter um ID de referência associado a eles. Inclua esse ID de referência ou outros identificadores (como um ID de comerciante) aplicáveis ao caso na sua consulta.
Acompanhamento de um caso
Se um caso enviado tiver sido encerrado e você tiver um acompanhamento dele, será possível "reabri-lo" usando o botão "Acompanhar um caso". Esse botão está localizado na parte de cima do caso fechado ao visualizá-lo na Ajuda do Portal de parceiros e na página Suporte > Casos.
Seu caso de acompanhamento aparecerá como um novo caso no Portal de parceiros 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, use o formulário de solicitação de acesso aos dados do usuário da empresa.