Neste artigo, abordamos o processo de ativar a API Menu para sua conta e fazer a integração. Confira abaixo uma visão geral detalhada do processo de integração e os pré-requisitos de lançamento. Consulte esta página ao 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 de dados antes do lançamento.
Configuraçã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 de menu estático. Se você tiver uma integração ativa do OwG Redirect ou do RwG para a qual está adicionando os metadados dos menus, sua conta atual será reutilizada para essa integração. Nos casos com integração do OwG Direct nessa plataforma ou sem nenhuma integração, uma nova conta é criada e os detalhes de acesso são compartilhados por e-mail.
Acesse sua conta no Portal do parceiro e navegue até a página de configuração dos feeds Configuração > Feeds. Há dois servidores SFTP relevantes para a integração do feed de dados do menu: Genérico e Comerciantes. Verifique se os dois servidores SFTP têm a chave pública SSH configurada. Para mais informações sobre como configurar chaves SSH, consulte esta página.
O
servidor SFTP genérico
pode aceitar vários feeds que podem seguir diferentes esquemas de dados. O tipo de feed
que aceita dados de menu estruturado é chamado de google.food_menu e
geralmente é ativado para sua conta por padrão no início da
integração. Se você tentar enviar um feed e receber esta mensagem de erro:
"O processamento do feed falhou. Houve um problema interno ao analisar seu feed. "google.food_menu" não está ativado. Corrija e tente novamente.", entre em contato 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 dados de contato estão atualizados.
Desenvolvimento
A fase de desenvolvimento contém a parte principal do esforço de implementação: gerar e testar os feeds de dados. Os feeds de dados precisam ser criados e enviados ao servidor SFTP de destino todos os dias. Os feeds enviados devem começar a ser processados em até uma hora após o envio. Consulte a especificação e os exemplos do feed de dados ao gerar seus feeds. Embora a especificação seja apresentada no formato protobuf, recomendamos fazer o upload de arquivos de feed no formato JSON, porque é mais fácil resolver problemas. Por isso, as amostras de feed também são fornecidas no formato JSON.
Um arquivo de feed de dados pode ser testado rapidamente usando a ferramenta on-line feed validator, que verifica se esse arquivo 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 que consiste em vários arquivos, faça upload dele no ambiente de sandbox e, depois que a transferência for concluída, consulte os resultados no Portal do parceiro. Durante a transferência do feed, há outras regras de validação aplicadas para testar algumas lógicas de negócios e a qualidade dos dados.
Lançamento
A fase 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 de restaurantes.
Pré-requisitos de lançamento
Estas condições precisam ser atendidas para que a integração seja iniciada:
- 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 passaram na avaliação de qualidade dos dados.
- A integração atende a todas as políticas e requisitos de cardápio de alimentos.
Avaliação de dados
Depois que os feeds de dados de produção forem ingeridos sem erros, talvez haja um processo interno para avaliar a qualidade dos dados do menu. O objetivo desse processo é encontrar inconsistências na qualidade dos dados, como conteúdo não relacionado a alimentos em descrições de pratos, incompatibilidade de nomes de pratos, preços etc. Em caso de descobertas desse tipo, o feedback será compartilhado com a equipe de desenvolvimento.