Informações gerais

Os parceiros do Google podem fornecer dados estruturados do cardápio ao Google pela integração de listas de espera de reservas para uso na seção Cardápio da ficha de um restaurante no Google Maps para dispositivos móveis (Android e iOS).

Os dados do cardápio são ingeridos usando os feeds genéricos. Antes de começar, reserve alguns minutos para concluir as etapas de configuração da conta e leia o artigo Como usar a caixa de depósito de feed genérica para ter uma visão geral do processo genérico de upload de feeds e uma explicação sobre como configurar sua conta para uploads de feeds genéricos.

Criar e fazer upload de feeds do cardápio

Ao criar e fazer o upload de feeds de menu, lembre-se do seguinte:

  • Siga a especificação de dados descrita no feed de menus para gerar os arquivos de dados. Os nomes dos arquivos de dados de menu devem ser exclusivos entre uploads. É recomendável incluir um carimbo de data/hora no nome do arquivo, por exemplo, menu1_1633621547.json.
  • No descritor do conjunto de arquivos, defina o campo name como google.food_menu. Para ver um exemplo do conteúdo do arquivo descritor, consulte a Amostra JSON do arquivo descritor. Os nomes dos arquivos descritores devem ser exclusivos entre uploads. É recomendável incluir um carimbo de data/hora no nome do arquivo, por exemplo, descriptor_1633621547.filesetdesc.json. O arquivo descritor deve ser enviado para a caixa de depósito SFTP genérica como parte do feed do menu.
  • Os feeds de menu precisam ser enviados para a caixa de depósito SFTP genérica em uma cadência diária como atualizações completas.
  • As informações da caixa de depósito SFTP do feed podem ser encontradas na seção Configuração > Feeds do Portal de parceiros.

    • Seleção de caixas de depósito de feeds

    Figura 1: informação genérica da caixa de depósito SFTP

Trabalhar com opções de itens de menu

As opções do item de menu podem ser especificadas usando o protótipo MenuItemOption. As opções de item de menu são exibidas como uma lista simples abaixo do item de menu. Veja o exemplo a seguir.

Itens do menu de preços com opções

Figura 2:pães e molhos têm duas opções de item de menu: Sm e Lg.

Somente as opções de item de menu obrigatórias são aceitas. Uma opção obrigatória de menu é aquela que o cliente precisa escolher ao fazer o pedido. Por exemplo, ao pedir uma pizza, o tamanho é uma opção obrigatória. As opções de item de menu que são opcionais (ou seja, "opção para adicionar abacate") não são compatíveis.

Como as opções de item de menu são exibidas como uma única lista simples, os parceiros com vários conjuntos de opções obrigatórias para um único item de menu (por exemplo, um café com opções de tamanho e leite) precisam decidir a melhor forma de mostrar essas opções no Google. O Google recomenda a seguinte heurística:

  • Se apenas um conjunto obrigatório de opções afetar o preço, inclua essa opção nos feeds.
  • Em todos os outros casos, cabe ao parceiro determinar a melhor forma de representar as opções do item do menu. Não é recomendável criar listas longas de opções para todas as combinações possíveis.

Ao incluir opções em um item de menu:

  • O item de menu precisa ter pelo menos uma oferta com um preço (para os casos em que as opções do item não afetam o preço).
  • O item de menu precisa ter um conjunto de opções com preços iguais ao preço total do item com essa opção selecionada.

O preço deve ser fornecido apenas para o item do menu ou para suas opções, mas não para ambos.

Depois que os feeds forem lançados, os dados do feed poderão ficar visíveis na guia "Cardápio" da ficha do restaurante. Se várias fontes oferecem cardápios para o mesmo restaurante, o comerciante pode escolher um fornecedor preferido no editor de cardápios do Perfil da Empresa no Google. Para mais informações sobre como um comerciante pode selecionar um provedor de cardápio preferido, consulte Gerenciar seu cardápio.

As seguintes plataformas do Google mostram a guia "Cardápio" na ficha:

Produto Dispositivo
Pesquisa Google Web para dispositivos móveis
Pesquisa Google Nativo para dispositivos móveis
Google Maps Nativo para dispositivos móveis
Nossos novos menus visuais estão visíveis na Pesquisa Google em dispositivos móveis, e a experiência será ampliada para outras plataformas, incluindo computadores e o Maps.

Exemplo de cardápio mostrando itens com descrições

Figura 3:exemplo de como o conteúdo do feed de menu é mostrado.

Para testar no computador, use as ferramentas para desenvolvedores do navegador para simular um dispositivo móvel.

  1. Na Visualização do inventário, selecione o comerciante e clique no link da ficha do restaurante para visualizá-la.
  2. Abra as Ferramentas para desenvolvedores do Chrome (clique com o botão direito do mouse em Inspecionar ou visualizar -> Desenvolvedor -> Ferramentas para desenvolvedores), selecione o tipo de dispositivo móvel Tipo de dispositivo móvel e atualize a página.

Práticas recomendadas

Veja a seguir as práticas recomendadas ao desenvolver feeds de menu.

  • Associe apenas um menu a um restaurante.
  • Forneça o idioma preferido como o primeiro idioma no TextField. Se você estiver enviando vários objetos LocalizedText, no momento, apenas o primeiro objeto da lista de texto será exibido aos usuários.
  • Todos os itens do menu precisam ser adicionados às seções do menu, e não diretamente ao objeto dele.
  • Forneça conteúdo usando a codificação utf-8. Não é necessário fazer escape de caracteres não ASCII.
  • Limite os arquivos ou fragmentos de feed a mil,conforme mencionado em Como usar a caixa de depósito de feed genérica.