O Visualizador de inventário permite:
- Pesquisar 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 bruto da entidade
- Á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 menu para o serviço pai e o restaurante ou vice-versa)
- Conferir qual versão de uma entidade o Google tem
Para acessar o Visualizador de inventário, abra o Centro 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 Inventory Viewer é compatível apenas com ambientes de produção e de sandbox. Não é possível usar o teste rápido.
Como usar o Visualizador de inventário
Comece acessando Inventário > Entidades de pedidos de comida ou clique neste link.
O Inventory Viewer tem duas visualizações: visualização de lista e visualização de detalhes.
Visualização de lista
Essa é a visualização que os usuários veem quando navegam pela ferramenta pela primeira vez. Ela 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 | É o carimbo de data/hora da última ingestão de modificação dessa entidade em feeds ou RTUs (no seu fuso horário). |
Outras colunas específicas da entidade incluem:
| Nome da coluna | Descrição |
|---|---|
| Nome | O nome da entidade nos feeds. |
| Status | O status de veiculação da entidade. Disponível apenas para restaurantes e serviços |
| Status de exclusão | O status excluído da entidade. Os valores são "Deleted" (Excluído) ou "Not deleted" (Não excluído). Disponível para todos os tipos de entidade, exceto serviço e restaurante |
| Tipo | Entrega ou Para viagem para serviços, optionType para MenuItemOptions |
Ao clicar em uma linha, você acessa a visualização detalhada da entidade.
Filtros da visualização em lista
Cada tabela de visualização de lista aceita um conjunto de filtros específico para esse tipo de entidade. Todas as entidades oferecem suporte à filtragem por ID da entidade (o ID fornecido ao Google em feeds e RTUs).
Alguns tipos de entidade oferecem suporte a filtros mais avançados. Confira abaixo uma tabela com alguns desses filtros.
| Chave | Operadores | Tipos de entidade aceitos | Descrição |
|---|---|---|---|
| Nome | =,contains | Restaurante, cardápio, seção de cardápio, item de menu | o nome da entidade fornecido nos feeds |
| SKU | = | MenuItemOffer | |
| Endereço | =,contains | 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 de exclusão | seleção múltipla | Todas as entidades, exceto restaurante e serviço | O status de exclusão da entidade (excluída ou não excluída) |
Visualização de detalhes
A visualização de detalhes é a que os usuários veem ao clicar em uma entidade na visualização de lista. A visualização detalhada contém outras informações sobre essa entidade, como:
- Motivo da desativação (para tipos de entidade "Restaurante" e "Serviço")
- Listar visualizações de entidades relacionadas
- O horário de indexação da entidade (horário da última sincronização com o DB de veiculação)
- 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 das entidades conforme informado no Visualizador de inventário. Somente restaurantes e serviços têm um status de exibiçã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 detalhada e conferir o motivo da não veiculação. |
| Pendente | A entidade foi adicionada ao 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 pode não ser a que está sendo veiculada devido aos tempos de processamento de entidades. Consulte as perguntas frequentes para mais detalhes.
Se uma entidade estiver desativada, abra a visualização de detalhes para conferir o Motivo da desativação.
| Motivo da desativação | Descrição | Como corrigir |
|---|---|---|
| O menu está ausente ou tem um erro | A entidade do menu está ausente ou tem um erro durante a transferência. | Verifique se uma entidade de cardápio está definida para o restaurante nos feeds de dados. Verifique se as referências de @id estão corretas. Verificar se há erros no menu usando o Inventory Viewer |
| O restaurante está ausente ou tem um erro | A entidade do restaurante está ausente nos feeds ou houve um erro durante a transferência. | Verifique se a entidade do restaurante está definida nos feeds de dados. Verifique se as referências de @id para a entidade do restaurante estão corretas. |
| Não é possível encontrar um restaurante válido no banco de dados do Google | Isso ocorre quando uma entidade de restaurante no seu feed de dados não pode ser associada a um restaurante válido no banco de dados do Google. | Verifique se o restaurante existe 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. |
| O serviço está ausente ou tem um erro | A entidade de serviço está ausente ou tem um erro durante a transferência. | Verifique se a entidade de serviço está definida para o restaurante nos feeds de dados. Verifique se as referências de @id estão corretas. Use o Inventory Viewer para verificar e corrigir erros relacionados à entidade de serviço. |
| Desativado temporariamente dos feeds | O restaurante está nos feeds de dados, mas o serviço foi desativado. | Envie uma atualização incremental ou uma transferência em lote para definir a propriedade isDisabled da entidade de serviço como falsa. |
| O restaurante desativou o recurso "Onde comer e beber" | O comerciante não está ativado no Pedido de ponta a ponta porque desativou o botão "Fazer o pedido" com as instruções em Configurar, ativar ou desativar o botão "Fazer o pedido". | Entre em contato com o restaurante e peça para ativar o botão "Fazer o pedido" com estas instruções: Configurar, ativar ou desativar o botão "Fazer o pedido". |
| O restaurante desativou o provedor | O comerciante desativou o botão "Fazer o pedido" usando as instruções em Configurar, ativar ou desativar o botão "Fazer o pedido" para você no Pedido de ponta a ponta porque informou que não tinha um relacionamento comercial com você. | Entre em contato com o comerciante e peça para ele ativar o botão "Pedir on-line" para o fornecedor usando o formulário de contato. |
| Marcada como fechada no Google: "Permanently Closed" | 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. |
| Marcada como fechada no Google: temporariamente fechada | O local aparece como permanentemente 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 restaurante dos seus feeds de dados são associadas ao mesmo restaurante no banco de dados do Google. | Remova entidades de restaurantes duplicadas dos seus feeds de dados. Se o mesmo restaurante tiver vários locais em um complexo (shopping, aeroporto ou centro comercial) ou em uma área próxima, 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 seus feeds de dados. | Atualize seus feeds de dados para garantir que cada restaurante não tenha serviços de entrega ou retirada duplicados. |
Entidades excluídas
Para entidades de restaurante e serviço excluídas, a coluna "Status" vai mostrar "Status excluído". Para todos os outros tipos de entidade, a visualização em lista terá uma coluna "Status excluído" cujo valor será "Excluído" ou "Não excluído". 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 entidades excluídas, e campos como "Nome" serão mostrados 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 vai continuar existindo e vai fornecer uma visão agregada dos status de veiculação.
Qual é a latência dos dados que aparecem no Inventory Viewer?
A latência de dados no Visualizador de inventário segue o tempo de ingestão e processamento. Para dados fornecidos em feeds em lote, a latência é de até 2 horas a partir do momento da ingestão. Para RTUs, é <5 minutos. A ingestão bem-sucedida significa uma das seguintes situações:
- O feed que continha a entidade tem o status "Sucesso" na tela Histórico de transferência.
- A RTU que continha a entidade não tem erros de validação no nível da solicitação ou da entidade, conforme informado em RTU Reporting.
O Inventory Viewer é compatível com o Quicktest?
Não. O Inventory Viewer é compatível apenas com ambientes de produção e de sandbox.
Corrigi 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 momento em que a ingestão foi concluída por feeds em lote ou cinco minutos para que as RTUs sejam refletidas no fluxo de pedidos do consumidor. Consulte as perguntas frequentes para saber mais sobre a latência. O Visualizador de inventário tem o status de veiculação atualizado. Assim, quando uma entidade muda o status de veiculação na interface do consumidor, ele é refletido quase instantaneamente no Visualizador de inventário.
Última modificação e horário de indexação
O Visualizador de inventário sempre mostra a versão mais recente de uma entidade. No entanto, depois que a ingestão for concluída, mas antes que a interface do consumidor seja atualizada com a versão mais recente, a versão do envio de entidade não vai corresponder à versão que acabou de ser ingerida e está sendo mostrada no Inventory Viewer. Isso ocorre devido ao tempo de processamento no pipeline de veiculação. O tempo de indexação é o momento em que os dados recebidos por feeds e RTUs foram sincronizados com o banco de dados de veiculação para serem veiculados nas plataformas do consumidor. Qualquer entidade com um Last Modified antes do Indexing Time será veiculada nas plataformas do consumidor.
Por exemplo, digamos que você adicione um serviço em feeds que termina a ingestão às 00:30:00 e é indexado às 01:30:00, começando a veiculação nesse momento. Em seguida, às 04h00min00s, você faz o upload de outro feed com uma nova versão desse serviço com isDisabled=true, e a ingestão desse feed é concluída às 04h30min00s. Depois que a segunda ingestão for concluída, o Inventory Viewer vai mostrar 1 de janeiro 04:30:00 GMT como o carimbo de data/hora Last Modified. No entanto, até que uma operação de indexação ocorra, o fluxo de pedidos do consumidor ainda vai veicular a versão que concluiu a ingestão às 00:30:00. Digamos que outra operação de indexação ocorra às 04h45min. Nesse ponto, o status desativado do serviço será atualizado na interface do consumidor, e essa entidade vai parar de ser veiculada. No entanto, durante todo o período de 01:30:00 (primeira operação de indexação) a 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.