O inventário v1 é uma estrutura hierárquica de entidades de feed no formato JSON-LD. Com esse esquema, os parceiros do programa de acesso antecipado podem usar o esquema para integração com a ordenação completa. O esquema de inventário v1 foi descontinuado.
A versão mais recente da especificação do feed de dados, o inventário v2, tem uma estrutura plana e usa um modelo de esquema relacional. Assim, os parceiros podem extrair e transformar entidades do banco de dados relacional de maneira mais direta para criar os feeds de dados. O inventário v2 está em NDJSON, que é um formato JSON delimitado por novas linhas.
Por que migrar da v1 para a v2
Embora continuemos oferecendo suporte de manutenção a parceiros com integrações de esquema de inventário de pedidos ponta a ponta, todas as novas integrações de parceiros precisam usar o inventário v2.
É possível que os novos recursos do inventário v2 não estejam disponíveis no inventário v1. Para ver um exemplo, consulte Transação.
Etapas de migração
O uso do inventário v2 exige um projeto de ponta a ponta do pedido separado e uma nova integração. O processo a seguir explica como migrar um inventário v1 para um inventário v2.
- Para criar um novo projeto v2, primeiro conclua as etapas de integração.
- Para implementar os feeds de dados, use o esquema de inventário relacional.
- Se aplicável, reutilize o endpoint de fulfillment do seu projeto v1.
- Quando o projeto v2 estiver pronto para lançamento, siga estas etapas:
- Verifique se o projeto v2 atende à lista de verificação de prontidão para lançamento.
- Para evitar que o esquema de inventário v1 e v2 seja exibido aos usuários finais, cancele a implantação da versão de produção do projeto v1. O inventário de projetos v1 deixará de ser exibido na produção alguns minutos após essa etapa.
- Crie uma versão de produção para seu projeto v2 e notifique seu consultor do Google.
Etapas de reversão
Para fazer a reversão para a v1 após a implantação do projeto v2 na produção, é possível cancelar a implantação da versão de produção no projeto v2 e, em seguida, reimplantar a versão de produção do projeto v1.
Impacto nos dados de parceiros e na classificação de provedores
Veja a seguir os possíveis impactos nos dados do parceiro e na classificação do provedor.
- Os registros de transações e os dados de análise do projeto v1 não são transferidos para o projeto v2.
- As métricas de desempenho, como taxas de conversão e métricas da API do projeto v1, não são transferidas para o projeto v2. Isso redefine sua classificação de provedores na ordenação completa.