Começar a usar os serviços de comparação de preços (CSS)

Realizar operações básicas com a API é uma boa maneira de começar a usá-la.

Pré-requisitos

Antes de começar, faça o seguinte:

  • Verifique se você tem uma conta válida do CSS Center.
  • Registre um desenvolvedor de API.
  • Verifique se a configuração de permissões está correta.
  • Verifique se você ativou a API CSS.
  • Verifique se você instalou as bibliotecas de cliente para seu ambiente.

Para mais informações, consulte o guia de início rápido.

Ativar a API CSS

Para se registrar como desenvolvedor e usar a API CSS, vincule sua conta do CSS Center e seu projeto do Google Cloud usando o método de registro de desenvolvedor, da seguinte forma:

Vincule o CSS Center e seu projeto do Google Cloud: a vinculação é estabelecida automaticamente, já que o autor da chamada tem acesso ao projeto do Google Cloud com base no token de acesso ou na chave de API e é um usuário autorizado da conta do CSS Center.

Registrar um desenvolvedor de API

Adicione um usuário desenvolvedor de API à conta do CSS Center: se um usuário já existir, ele vai receber o novo tipo de acesso "Desenvolvedor de API". Se for um novo usuário, ele vai receber um convite por e-mail do CSS Center.

Depois do registro, é possível conferir o status usando GetDeveloperRegistration ou cancelar o registro usando UnregisterGCP. É possível usar a seguinte chamada de registro:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
      developer_email:"example-email@example.com"
}

Depois que a solicitação for executada, aguarde a resposta:

{
      "developerRegistration":
{
            "name": "accounts/ACCOUNT_ID/developerRegistration",
           "gcpIds": [
            "GOOGLE_CLOUD_PROJECT_ID"
        ]
    }
}

Produtos do CSS

Assim como a sub-API Products, a API CSS diferencia CssProductInput de ListCssProduct. Insira um produto com InsertCssProductInput.

Depois que nossos sistemas internos processarem o produto (isso pode levar alguns minutos), recupere-o com ListCssProducts.

Identifique seus produtos usando raw_provided_id. Recomendamos que você use um identificador que já esteja usando no seu sistema. Como alternativa, os métodos comuns para criar um incluem o uso de um dos seguintes:

  • Identificadores exclusivos globais (GUIDs)
  • Identificadores universais exclusivos (UUIDs)
  • Atributos de produto exclusivos concatenados (por exemplo, marca_modelo_cor_tamanho)

Para mais informações, consulte Inserir/listar/atualizar/excluir um produto.

Operações básicas

Confira alguns comandos básicos que você pode usar.

  1. Insira um produto de teste usando InsertCssProductInput. Para receber ajuda sobre os atributos a serem enviados, consulte este exemplo de código.

  2. Liste todos os seus produtos usando ListCssProducts. Há um pequeno atraso no processamento entre a inserção de um produto e a exibição dele na lista. Se você não encontrar um imediatamente, tente de novo depois de alguns segundos.

  3. Atualize um único produto usando UpdateCssProductInput com seu cssproductinput.name. Você só precisa enviar os atributos necessários para serem atualizados. Para ver um exemplo, consulte o código de amostra.

  4. Exclua o produto de teste usando DeleteCssProductInpu, fornecendo o raw_provided_id.

Limitações

Inserir ou excluir um produto individual pode ser lento. Para melhorar o desempenho, use Async. Isso permite chamar a API em paralelo.

Listar e rotular suas contas

Com o gerenciamento de rótulos na API CSS, é possível organizar de forma programática as contas do Merchant Center dos clientes usando tags personalizadas. Esse recurso ajuda você a categorizar clientes de maneira eficiente (por exemplo, por tipo ou estratégia), permitindo uma melhor organização e operações simplificadas. É possível usar a API para realizar as seguintes funções em rótulos: