Este artigo aborda o processo de ativação da API de menu para sua conta e a integração com ela. Veja abaixo uma visão geral detalhada do processo de integração e dos pré-requisitos de lançamento. Consulte esta página quando planejar a integração.
- Configuração: configuração da conta e planejamento do processo de desenvolvimento.
- Desenvolvimento: desenvolvimento e teste de feeds de dados.
- Lançamento: avaliação dos dados antes do lançamento.
Instalação
Nesta etapa, é importante confirmar se sua conta no Portal do parceiro está totalmente configurada e pronta para aceitar feeds de dados relevantes para dados estáticos do menu. Se você tiver uma integração ativa de redirecionamento ou RwG do OwG a que está adicionando os metadados de menus, sua conta atual será reutilizada para essa integração. Nos casos em que há integração do OwG Direct nessa plataforma ou nenhuma integração, uma nova conta é criada, e os detalhes de acesso são compartilhados por e-mail.
Acesse sua conta no Portal de parceiros e navegue até a página de configuração da caixa de depósito Configuração > Feeds. Há duas caixas de depósito relevantes para a integração do feed de dados do menu: Genérico e Comerciantes. Verifique se as duas caixas de depósito têm a chave pública SSH configurada. Para mais informações sobre como configurar chaves SSH, consulte esta página.
A caixa de depósito genérica pode aceitar vários feeds que seguem diferentes esquemas de dados. O tipo de feed que aceita dados estruturados de menu é chamado de google.food_menu e geralmente é ativado para sua conta por padrão no início da integração. Caso você tente enviar um feed e receba a mensagem de erro "Falha no processamento do feed. Ocorreu um problema interno ao analisar seu
feed. O 'google.food_menu' não está ativado. Corrija e tente novamente.", fale com seu ponto de contato do Google para ativar esse tipo de feed.
Por fim, acesse a página Configuração > Informações de contato e verifique se todos os seus detalhes de contato estão atualizados.
Desenvolvimento
O estágio de desenvolvimento contém a parte principal do esforço de implementação, que é gerar e testar os feeds de dados. Feeds de dados precisam ser criados e enviados para a caixa de depósito de destino todos os dias. Espera-se que os feeds enviados no sandbox comecem o processamento dentro de uma hora após o envio. Os feeds de produção são processados uma vez por dia às 12h no fuso horário do Pacífico (PST, na sigla em inglês). Apenas o feed mais recente enviado é processado. Consulte a especificação e os exemplos do feed de dados ao trabalhar na geração dos seus feeds. Embora a especificação seja apresentada no formato protobuf, recomendamos fazer upload dos arquivos de feed no formato JSON, porque é mais fácil resolver os problemas. Por esse motivo, as amostras de feed também são fornecidas no formato JSON.
É possível testar rapidamente um arquivo de feed de dados usando a ferramenta on-line validador de feeds, que verifica se ele corresponde à especificação. A ferramenta mostra se o arquivo corresponde ao esquema de dados. Caso contrário, ela gera a lista de erros. Para testar um feed de dados inteiro composto por vários arquivos, faça o upload desse feed no ambiente do sandbox e, após a conclusão do processamento, veja os resultados no Portal do parceiro. Durante a ingestão do feed, outras regras de validação são aplicadas para testar a lógica de negócios e a qualidade dos dados.
Iniciar
A etapa de lançamento pode ser iniciada depois que todo o trabalho de integração for concluído e o feed de produção refletir corretamente todo o inventário de cardápios do restaurante.
Pré-requisitos de inicialização
Estas condições precisam ser atendidas para a integração ser lançada:
- Os feeds de dados são processados no ambiente de produção sem erros.
- O feed de dados de produção contém o inventário completo com escopo para essa integração no início dela.
- A maioria dos dados do comerciante corresponde aos locais do Google Maps.
- Os feeds de produção foram aprovados na avaliação de qualidade de dados.
- A integração atende a todas as políticas e requisitos do cardápio.
Avaliação dos dados
Depois que os feeds de dados de produção estiverem sendo ingeridos sem erros, pode haver um processo interno para avaliar a qualidade dos dados do cardápio. Esse processo visa encontrar inconsistências na qualidade dos dados, como conteúdo não relacionado a alimentos nas descrições dos pratos, incompatibilidade nos nomes e preços dos pratos etc. Nesse caso, o feedback será compartilhado com a equipe de desenvolvimento.