Iniciar a migração

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

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

Planejar a migração

  1. Mapeie seus 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ê consulte e tenha em mente os seguintes recursos, que serão úteis para sua migração:

    • Migrar da visão geral da API Content: detalha as principais mudanças na API Merchant.
    • Guias de migração específicos da sub-API: consulte os guias de migração específicos da sub-API que você precisa, porque eles fornecem informações importantes, 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 amostra.
    • Guias específicos de recursos: para implementar novos recursos ou ter 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 disso, você pode determinar o esforço necessário e uma lista de prioridades de sub-APIs para trabalhar.

    Recomendamos migrar tudo ou o máximo possível. Se não for possível 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, crie 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. Confira todo o processo neste link.

  2. Teste diferentes métodos para ajudar você a aumentar a velocidade. 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. Use nossos exemplos de código e bibliotecas de cliente.

    Para reduzir o tempo de implementação e aproveitar os benefícios do gRPC, use as bibliotecas de cliente e os exemplos de código.

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

  4. Teste jornadas simples do usuário.

    Faça 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 continua baixa.

Planejar o lançamento

Recomendamos a seguinte abordagem:

  • Implemente uma sub-API ou um método por vez.
  • Implemente apenas em um pequeno segmento da empresa por vez.
  • Monitore para identificar problemas a qualquer momento.

Implementar a migração

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

    Depois do teste inicial e do 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.