Iniciar a migração

Nesta página, fornecemos orientações sobre como planejar a migração da API e descrevemos as etapas necessárias.

Planejar a migração

1. Mapeie seus métodos da API Content for Shopping para os métodos da API Merchant.

   Entenda os novos métodos e recursos necessários para a API Merchant.

2. Entenda as mudanças mais significativas que se aplicam à sua migração.

   Consulte os seguintes recursos para ajudar na migração:

   • Visão geral da migração da API Content: detalha as principais mudanças que você precisa conhecer na API Merchant.
   • Guias de migração específicos de sub-APIs: consulte os guias de migração específicos de sub-APIs necessários, pois eles fornecem informações essenciais, como novos mapeamentos de campos. Para ver um exemplo, consulte Migrar o gerenciamento de produtos.
   • A referência da API Merchant fornece os detalhes dos recursos e métodos da API Merchant.
   • O guia de Início rápido mostra como começar a usar a API Merchant para criar uma conta e fazer upload de um produto de exemplo.
   • Guias específicos de recursos: para implementar novos recursos ou esclarecer dúvidas, consulte os guias de recursos fornecidos na navegação.

3. Identifique as sub-APIs que você planeja migrar e quer implementar.

   Determine duas coisas:

   • Os recursos da API Merchant que você precisa migrar
   • Os novos recursos que você quer implementar

   Depois disso, você pode determinar o esforço necessário e uma lista de prioridades de sub-APIs para trabalhar.

   Se não for possível migrar toda a implementação da API Content inicialmente, priorize as seguintes sub-APIs com base na importância e na complexidade.

   • Contas
   • Produtos
   • Fontes de dados
   • Relatórios

Etapas da migração

1. Registrar-se como desenvolvedor Para usar a API Merchant, é necessário criar um link entre seu projeto do Google Cloud e sua conta principal do Merchant Center. Esse registro único é necessário para cada projeto do Google Cloud que você usa com a API Merchant. Você pode acompanhar todo o processo na página de visão geral.

2. Teste diferentes métodos para ajudar você a se preparar. Recomendamos o uso do Google APIs Explorer para realizar testes básicos.

   O formato dos URLs de solicitação para a API Merchant é:

   https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}…
   

3. Aproveite nossos exemplos de código e bibliotecas de cliente.

   Para ajudar a reduzir o tempo de implementação e se beneficiar do gRPC, use as bibliotecas de cliente e os exemplos de código.

   Os guias incluem snippets de exemplo de código. Por exemplo, consulte Adicionar um produto.

4. Teste jornadas simples do usuário.

   Realize testes de jornada do usuário em todas as sub-APIs e funcionalidades que você planeja migrar com os seguintes objetivos:

   • Os recursos e as chamadas migradas têm resultados de resposta corretos.
   • A proporção de erros permanece baixa.

Planeje o lançamento

Recomendamos a seguinte abordagem:

• Implemente uma sub-API ou um método por vez.
• Implementar em apenas um pequeno segmento da empresa por vez.
• Monitore problemas o tempo todo.

Implementar a migração

1. Trabalhar na programação usando os novos recursos e endpoints.

   Após os testes iniciais e o desenvolvimento de um plano de lançamento, integre a API Merchant aos seus fluxos de trabalho.

2. Monitorar.

   Prepare-se para resolver possíveis problemas.