Visão geral

Os parceiros do Google podem fornecer dados estruturados de cardápio ao Google pela integração completa de reservas para uso na seção Menu da ficha do local 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 garantir que você concluiu as etapas de configuração da conta e leia o artigo Como usar a caixa de depósito genérica de feeds para ter uma visão geral do processo de upload de feeds genéricos e uma explicação sobre como configurar sua conta para uploads de feeds genéricos.

Como criar e fazer upload de feeds de cardápio

Ao criar e fazer upload de feeds de cardápio, lembre-se do seguinte:

  • Siga a especificação de dados descrita no feed de menu para gerar os arquivos de dados do menu. Os nomes dos arquivos de dados do menu precisam ser exclusivos entre os uploads. É recomendável incluir um carimbo de data/hora no nome do arquivo, por exemplo, menu1_1633621547.json.
  • No descritor de conjunto de arquivos, defina o campo name como google.food_menu. Para conferir um exemplo do conteúdo do arquivo de descritor, consulte o exemplo de JSON do arquivo de descritor. Os nomes dos arquivos de descrições precisam ser exclusivos entre os uploads. É recomendável incluir um carimbo de data/hora no nome do arquivo, por exemplo, descriptor_1633621547.filesetdesc.json. O arquivo descritor precisa ser enviado para a caixa de depósito genérica do SFTP como parte do feed de menu.
  • Os feeds de cardápio precisam ser enviados para a caixa de depósito genérica de SFTP diariamente 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.
  • Como selecionar caixas de depósito de feed

    Figura 1:Informações genéricas da caixa de depósito SFTP

Como trabalhar com opções de itens de menu

As opções de itens de menu podem ser especificadas usando o proto MenuItemOption. As opções de item de menu são mostradas como uma lista simples abaixo do item de menu. Veja o exemplo abaixo.

Definir preços de itens de menu com opções

Figura 2. Bread Sticks & Sauce tem duas opções de itens do menu: Sm e Lg

Somente as opções de item de menu obrigatórias são aceitas. Uma opção de item de menu obrigatória é aquela que o cliente precisa escolher ao fazer o pedido. Por exemplo, ao pedir uma pizza, o tamanho é uma opção obrigatória. Não é possível usar opções de itens de menu opcionais (por exemplo, "opção de adicionar abacate").

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

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

Ao incluir opções de item de menu em um item de menu, faça o seguinte:

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

O preço precisa ser fornecido apenas para o item do menu ou para as opções dele, mas não para os dois.

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

As plataformas do Google a seguir mostram a guia "Menu" na Placesheet:

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

Exemplo de menu mostrando itens de menu com descrições

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

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

  1. Na Visualização de inventário, selecione o comerciante e clique no link da ficha do lugar para acessar a ficha do restaurante.
  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

Confira a seguir as práticas recomendadas para seguir ao desenvolver feeds de cardápio.

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