Contas de teste na API Merchant

O recurso de contas de teste da API Merchant oferece um espaço seguro e isolado para testar as integrações antes de implantá-las em um ambiente de produção. Ao usar contas de teste em sandbox, você pode experimentar chamadas de API, validar códigos e identificar possíveis problemas no início do ciclo de desenvolvimento, sem afetar os dados de produção, interromper as operações em tempo real ou violar inadvertidamente as políticas do Merchant Center.

Pré-requisitos

Antes de criar e usar contas de teste, verifique se você atende aos seguintes requisitos:

  • Conta do Merchant Center:é necessário ter uma conta do Merchant Center.
  • Acesso à API Merchant: é necessário ser um usuário registrado da API Merchant.

Benefícios das contas de teste

O uso de contas de teste oferece várias vantagens importantes:

  • Configuração simples:a configuração da conta de teste é um processo de baixa complexidade que permite começar a testar seus recursos e integrações rapidamente.
  • Integridade e segurança dos dados:os dados de produção permanecem protegidos, e o risco de violações de política nas contas de produção é eliminado.
  • Eficiência dos testes:você pode testar uma ampla variedade de cenários diversos e casos extremos sem o ônus de manter uma conta de produção paralela para fins de teste.
  • Validação imediata da oferta:aproveite a isenção automática da reivindicação e verificação da página inicial para contas de teste e teste as inserções de ofertas rapidamente. As ofertas são aprovadas por padrão para contas de teste.
  • Simulação realista:o ambiente espelha o comportamento de produção para funcionalidades críticas, como uploads de produtos e gerenciamento de inventário, garantindo que os resultados dos testes sejam confiáveis.
  • Migrações de API mais suaves:as contas de teste facilitam uma transição confiante e perfeita para quem está migrando da API Content para a API Merchant ou de uma versão da API para outra, permitindo a validação lado a lado.

Como criar contas de teste

As contas de teste são criadas usando um método personalizado específico na API Merchant.

Use o método accounts.createTestAccount:

  POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}:createTestAccount
  Content-Type: application/json
  Authorization: Bearer {ACCESS_TOKEN}"

  {
    "account_name": "{TEST_ACCOUNT_NAME}",
    "time_zone": {
      "id": "America/Los_Angeles"
    },
    "language_code": "en-US"
  }

Substitua:

  • ACCOUNT_ID: seu ID do Merchant Center.
  • ACCESS_TOKEN: o token de autorização para fazer a chamada de API.
  • TEST_ACCOUNT_NAME: o nome da conta de teste. Recomendamos o uso de nomes significativos que sugiram que eles são usados para testes. Por exemplo, inclua a palavra test no nome da conta de teste.

Os campos a seguir são obrigatórios ao criar uma conta de teste:

  • time_zone: o fuso horário de relatórios e exibição da conta.
  • language_code: o código de idioma BCP-47 da conta, como en-US.

Uma chamada bem-sucedida retorna um recurso de conta que inclui o accountId exclusivo e o nome do recurso da nova conta de teste:

  {
    "name": "accounts/{TEST_ACCOUNT_ID}",
    "accountId": "{TEST_ACCOUNT_ID}",
    "accountName": "{TEST_ACCOUNT_NAME}",
    "adultContent": false,
    "testAccount": true,
    "timeZone": {
      "id": "America/Los_Angeles"
    },
    "languageCode": "en-US"
  }

Limitações

As contas de teste são projetadas para validação funcional e têm restrições específicas:

  • Número de contas de teste:é possível criar no máximo cinco contas de teste por Conta do Google. As contas de teste são consideradas no limite padrão de contas do Merchant Center por Conta do Google.
  • Integração com cotas da API Merchant:do ponto de vista da cota da API, a API Merchant trata as contas de teste como contas de produção. As contas de teste estão sujeitas às mesmas cotas que as contas de produção. Não é possível aumentar a cota das contas de teste.
  • Contas avançadas:não é possível criar contas de teste avançadas nem converter uma conta avançada em uma conta de teste.
  • Sem veiculação pública:os dados enviados a uma conta de teste nunca serão publicados em nenhuma plataforma do Google, como a Pesquisa ou os anúncios do Shopping.
  • Endpoints restritos:não é possível usar contas de teste ao usar determinados recursos, como:
  • Restrições de vinculação:não é possível vincular contas de teste a outras contas do Google Ads ou do Perfil da Empresa no Google.
  • Sem registro para contas de teste: não é possível fazer o registro de contas de teste.

Práticas recomendadas

Recomendamos seguir algumas práticas recomendadas ao usar contas de teste:

  • Desenvolvimento em sandbox:sempre valide novos recursos de integração em uma conta de teste antes de aplicá-los ao ambiente de produção.
  • Teste de integração automatizado:use contas de teste como ambientes estáveis para executar testes de regressão automatizados.
  • Nomeação de contas de teste:use o account_name para indicar a finalidade de cada conta de teste, como "Teste de migração" ou "Conta de teste de integração".