Iniciar a migração

Nesta página, oferecemos orientações sobre como planejar a migração da API.

Em seguida, apresentamos uma visão geral das etapas necessárias para a migração.

Planejar a migração

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

    É muito útil entender claramente 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.

    Recomendamos que você analise e tenha em mente os seguintes recursos, porque eles serão úteis para a 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 da sub-API: analise os guias de migração específicos da sub-API de que você precisa, porque eles fornecem informações importantes, como novos mapeamentos de campos. Para 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 o upload de um produto de amostra.
    • Guias específicos de recursos: para a implementação de novos recursos ou para mais esclarecimentos, consulte os guias de recursos fornecidos na navegação.

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

    Determine duas coisas:

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

    Depois de fazer isso, você pode determinar a quantidade de esforço e uma lista de prioridades de sub-APIs para trabalhar.

    Recomendamos migrar tudo ou o máximo possível. Se você não conseguir migrar toda a implementação da API Content inicialmente, devido à importância e complexidade, priorize as seguintes sub-APIs.

Etapas da migração

  1. Registre-se como desenvolvedor : para usar a API Merchant, você precisa criar um link entre seu projeto do Google Cloud e sua conta principal do Merchant Center. Esse registro único é obrigatório para cada projeto na nuvem do Google Cloud que você usa com a API Merchant. Você pode seguir todo o processo aqui.

  2. Teste diferentes métodos para ajudar você a acelerar. Recomendamos usar o Google APIs Explorer para realizar testes básicos.

    O formato dos URLs de solicitação da 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 aproveitar o gRPC, use as bibliotecas de cliente e os exemplos de código.

    Também incorporamos exemplos de snippets de código nos nossos guias. Por exemplo, consulte Adicionar um produto.

  4. Teste jornadas de usuário simples.

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

    • Seus recursos e chamadas migrados têm resultados de resposta corretos.
    • A taxa de erros permanece baixa.

Planejar o lançamento

Recomendamos a seguinte abordagem:

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

Implementar a migração

  1. Trabalhe na codificação usando os novos recursos e endpoints.

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

  2. Monitoramento.

    Prepare-se para resolver possíveis problemas.