O Visualizador de inventário é uma ferramenta que permite:
- Procurar entidades com base no ID do provedor (o ID fornecido nos feeds)
- Confira detalhes específicos da entidade, incluindo:
- Nome da entidade
- Endereço do restaurante
- JSON de entidade bruta
- Área de cobertura
- Horas
- Status de veiculação nas plataformas do consumidor
- Links para o fluxo de pedidos do consumidor
- e mais
- navegar entre entidades relacionadas (ou seja, navegar de um cardápio para seu serviço pai e restaurante ou vice-versa);
- Conferir qual versão de uma entidade o Google tem
Para acessar o Leitor de inventário, abra a Central de ações e navegue até Inventário > Entidades de pedidos de comida ou clique neste link.
Todos os usuários com acesso de Leitor ou superior à sua conta da Central de ações têm acesso automático ao Visualizador de inventário.
O Visualizador de inventário oferece suporte somente aos ambientes de produção e sandbox. O Teste rápido não é compatível.
Como usar o Visualizador de inventário
Comece acessando Inventário > Entidades de pedidos de comida ou clique neste link.
O Visualizador de inventário tem duas visualizações: visualização em lista e visualização de detalhes.
Visualização de lista
Essa é a visualização que os usuários veem quando acessam a ferramenta pela primeira vez. Ele contém uma tabela com uma guia para cada tipo de entidade. Cada guia contém uma tabela paginada de todas as entidades desse tipo. As colunas variam de acordo com o tipo de entidade, mas sempre incluem:
| Nome da coluna | Descrição |
|---|---|
| ID da entidade | ID da entidade fornecido pelo parceiro (de feeds em lote e RTUs) |
| Última modificação | Este é o carimbo de data/hora da última ingestão modificada dessa entidade em feeds ou RTUs (no seu fuso horário). |
Outras colunas específicas de entidades incluem:
| Nome da coluna | Descrição |
|---|---|
| Nome | É o nome da entidade nos feeds. |
| Status | Status de veiculação da entidade. Disponível apenas para restaurantes e serviços |
| Status excluído | O status excluído da entidade. Os valores são "Excluído" ou "Não excluído". Disponível para todos os tipos de entidades, exceto serviços e restaurante |
| Tipo | Delivery ou Takeout para Serviços, optionType para MenuItemOptions |
Ao clicar em uma linha, a visualização de detalhes da entidade será exibida.
Filtros da visualização em lista
Cada tabela de visualização em lista é compatível com um conjunto de filtros específicos para esse tipo de entidade. Todas as entidades oferecem suporte à filtragem por ID da entidade (o ID fornecido ao Google nos feeds e RTUs).
Alguns tipos de entidade oferecem suporte a filtros mais avançados. Abaixo está uma tabela que lista alguns desses filtros.
| Chave | Operadores | Tipos de entidade compatíveis | Descrição |
|---|---|---|---|
| Nome | =,contém | Restaurante, Menu, Menuseção, MenuItem | o nome da entidade fornecido nos feeds |
| SKU | = | MenuItemOffer | |
| Endereço | =,contém | Restaurante | O endereço fornecido nos feeds |
| Status de veiculação | seleção múltipla | Restaurante, serviço | O status de veiculação na interface do consumidor |
| Status excluído | seleção múltipla | Todas as entidades, exceto restaurantes e serviços | O status da entidade excluído (excluída ou não excluída) |
Visualização de detalhes
A visualização de detalhes é aquela que os usuários veem ao clicar em uma entidade na visualização em lista. A visualização de detalhes contém mais informações sobre a entidade, como:
- Motivo da desativação (para os tipos de entidade "Restaurante" e "Serviço")
- Listar visualizações de entidades relacionadas
- O Horário de indexação da entidade (hora da última sincronização com o banco de dados exibido).
- O JSON bruto de feeds ou RTUs
- Visualizações combinadas de entidades relacionadas (por exemplo, OperationHours, ServiceAreas, price)
- Links para fluxos de pedidos de produção e teste (somente restaurantes e serviços)
Status e como corrigir erros
A tabela a seguir descreve os status de veiculação de entidades, conforme informado no Visualizador de inventário. Somente restaurantes e serviços têm status de serviço.
| Status | Descrição |
|---|---|
| Ativado | A entidade está qualificada para veiculação nas plataformas do Google. |
| Desativada | A entidade não está sendo veiculada no Google. Clique na linha para abrir a visualização de detalhes e saber por que ela não está sendo veiculada. |
| Pendente | A entidade foi adicionada no feed mais recente, mas ainda não está sendo veiculada. |
| Excluída | A entidade foi excluída em um feed ou RTU. As entidades excluídas são mantidas por 30 dias. |
A versão exibida no Visualizador de inventário talvez não seja a que está sendo veiculada devido aos tempos de processamento da entidade. Consulte as perguntas frequentes para ver mais detalhes.
Se uma entidade estiver desativada, abra a visualização detalhada para conferir o Motivo da desativação.
| Motivo da desativação | Descrição | Como corrigir |
|---|---|---|
| Menu ausente ou com um erro | A entidade do menu está ausente ou tem um erro durante a ingestão. | Verificar se uma entidade do menu está definida para o restaurante nos feeds de dados. Verifique se as referências @id estão corretas. Use o Visualizador de inventário para verificar se há erros no menu |
| O restaurante não existe ou tem um erro | A entidade do restaurante não está presente nos feeds ou teve um erro durante o processamento. | Verifique se a entidade do restaurante está definida nos feeds de dados. Verifique se as referências de @id à entidade do restaurante estão corretas. |
| Não foi possível fazer a correspondência com um restaurante válido no banco de dados do Google | Isso ocorre quando uma entidade de restaurante no seu feed de dados não consegue corresponder a um restaurante válido no banco de dados do Google. | Verifique se o restaurante aparece na Pesquisa Google e no Maps. Se o restaurante não existir, siga as instruções em "Como adicionar ou reivindicar seu Perfil da Empresa no Google". Verifique se o nome e o endereço no arquivo do feed de dados correspondem exatamente ao nome e ao endereço no Perfil da Empresa. |
| Serviço ausente ou com um erro | A entidade de serviço está ausente ou tem um erro durante a ingestão. | Verifique se a entidade de serviço está definida para o restaurante nos feeds de dados. Verifique se as referências @id estão corretas. Use o Visualizador de inventário para verificar e corrigir erros relacionados à entidade de serviço. |
| Temporariamente desativado dos feeds | O restaurante está nos feeds de dados, mas o serviço dele foi desativado. | Envie uma atualização incremental ou uma ingestão em lote para definir a propriedade isDisabled da entidade de serviço como falsa. |
| Restaurante que não aceitou o OwG | O comerciante não ativou a opção "Pedido completo" porque ele escolheu desativar o botão "Pedir on-line" seguindo as instruções em Configurar, ativar ou desativar o botão "Fazer o pedido". | Entre em contato com o restaurante e peça para ele ativar o botão "Pedir on-line" em Configurar, ativar ou desativar o botão "Pedir on-line". |
| Restaurante que não aceitou o provedor | O comerciante desativou o pedido on-line seguindo as instruções em Configurar, ativar ou desativar o botão "Pedir on-line" em "Pedidos de ponta a ponta", porque ele informou que não tem uma relação comercial com você. | Solicite que o comerciante ative o botão "Pedir on-line" usando o formulário de contato. |
| Marcado como fechado no Google – Permanentemente fechado | O local aparece como permanentemente fechado no Painel de informações do Google. | Os comerciantes podem seguir as instruções em Como definir o horário de funcionamento ou marcar uma empresa como fechada para marcar o local como reaberto no Perfil da Empresa. |
| Marcado como fechado no Google – Temporariamente fechado | O local aparece como permanente ou temporariamente fechado no "Painel de informações" do Google. | Os comerciantes podem seguir as instruções em Como definir o horário de funcionamento ou marcar uma empresa como fechada para marcar o local como reaberto no Perfil da Empresa. |
| Restaurantes duplicados | Isso significa que várias entidades de restaurantes dos seus feeds de dados correspondem ao mesmo restaurante no banco de dados do Google. | Remova as entidades de restaurante duplicadas dos seus feeds de dados. Se o mesmo restaurante tiver vários locais em um complexo (centro, aeroporto ou shopping center) ou próximos um do outro, verifique se cada um deles tem um local separado no Perfil da Empresa no Google (instruções) e corresponde a uma única entidade nos feeds de dados. |
| Serviços duplicados | Isso significa que vários serviços do mesmo tipo (entrega ou retirada) dos seus feeds de dados estão vinculados ao mesmo restaurante no banco de dados do Google. Exemplo: duas entidades de serviço de entrega estão configuradas para o mesmo restaurante nos feeds de dados. | Atualize seus feeds de dados para garantir que os restaurantes não tenham serviços de entrega ou para viagem duplicados. |
Entidades excluídas
A coluna "Status" de entidades de restaurante e serviço mostra "Status excluído". Para todos os outros tipos de entidade, a visualização em lista conterá uma coluna "Status excluído", cujo valor será "Excluída" ou "Não excluída". As entidades excluídas são armazenadas por 30 dias após os eventos de exclusão. O Visualizador de inventário não terá informações completas sobre as entidades excluídas, e campos como "Nome" serão exibidos como "Desconhecido".
Perguntas frequentes
O relatório do visualizador de inventário substitui o relatório de status do restaurante?
Não. O Relatório de status do restaurante continuará existindo e fornecendo uma visualização agregada dos status de veiculação.
Qual é a latência dos dados que aparecem no Visualizador de inventário?
A latência dos dados no Visualizador de inventário acompanha o tempo de ingestão e processamento. Para dados fornecidos em feeds em lote, a latência é de até duas horas a partir do ponto de ingestão bem-sucedida. Para RTUs, é menos de cinco minutos. A ingestão bem-sucedida significa:
- O feed com a entidade tem o status "Concluído" na tela Histórico de processamento.
- A RTU que continha a entidade não tem erros de validação no nível da solicitação ou da entidade, conforme relatado nos Relatórios de RTU.
O Visualizador de inventário oferece suporte ao Teste rápido?
Não. O Leitor de inventário oferece suporte apenas aos ambientes de produção e sandbox.
Corrigimos o problema que impedia a veiculação de um restaurante, mas ele ainda aparece como "Desativado" no Visualizador de inventário.
Os dados podem levar até duas horas a partir do ponto de ingestão por meio de feeds em lote ou cinco minutos para que as RTUs reflitam o fluxo de pedido do consumidor. Consulte as Perguntas frequentes para ver detalhes sobre latência. O Visualizador de inventário tem status de veiculação atualizado. Assim, quando uma entidade muda o status de veiculação na interface do consumidor, isso é refletido quase imediatamente no Visualizador de inventário.
Horário da última modificação e indexação
O Visualizador de inventário sempre mostra a versão ingerida mais recente de uma entidade. No entanto, após a conclusão da ingestão, mas antes que a interface do consumidor seja atualizada com a versão mais recente, a versão da entidade exibida não vai corresponder à versão que acabou de ser ingerida e vai ser exibida no Visualizador de inventário. Isso ocorre devido ao tempo de processamento no pipeline de disponibilização. O tempo de indexação é o momento em que os dados recebidos por feeds e RTUs são sincronizados com o banco de dados de exibição para veiculação nas superfícies do consumidor. Qualquer entidade com o horário da Última modificação anterior ao Horário de indexação será mostrada nas plataformas do consumidor.
Por exemplo, digamos que você adicione um serviço nos feeds que termina o processamento às 00:30:00, é indexado às 01:30:00 e começa a ser veiculado nesse momento. Em seguida, às 4:00:00, você faz o upload de outro feed com uma nova versão desse serviço com isDisabled=true, e o feed termina de ser processado às 04:30:00. Após a conclusão do segundo processamento, o Leitor de inventário mostrará 1o de janeiro às 4h30 GMT como o carimbo de data/hora Última modificação. No entanto, até que uma operação de indexação ocorra, o fluxo de pedidos do consumidor ainda estará exibindo a versão que concluiu a ingestão às 00:30:00. Digamos que outra operação de indexação ocorra às 4:45:00. Nesse momento, o status desativado do serviço será atualizado na interface do consumidor, e essa entidade deixará de ser veiculada. No entanto, durante todo o período de 01:30:00 (primeira operação de indexação) até 04:45:00 (segunda operação de indexação), o status da entidade será "Ativado", já que uma versão anterior da entidade estava sendo veiculada na interface do consumidor.