Este artigo aborda 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
Nessa 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 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 do parceiro e navegue até a página de configuração Configuração > Feeds. Há duas caixas suspensas 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.
O
dropbox genérico
pode aceitar vários feeds que seguem esquemas de dados diferentes. O tipo de feed
que aceita dados de menu estruturado é chamado de google.food_menu e
geralmente é ativado na sua conta por padrão no início da
integração. Caso você tente enviar um feed e receba 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 para a caixa de entrada de destino todos os dias. Os feeds enviados no sandbox devem começar a ser processados 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. Somente o feed mais recente enviado é processado. Consulte a especificação e os exemplos 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.