Google Categories

Visão Geral

O módulo de Google Categories fornece acesso à lista oficial de categorias do Google Shopping.

Ele é essencial para o processo de mapeamento de produtos, garantindo que as categorias internas da loja sejam correlacionadas corretamente com as categorias aceitas pelo Google para campanhas de anúncios.

A taxonomia do Google é utilizada para classificar os produtos de forma padronizada, facilitando a indexação e a exibição em resultados de busca.

Através deste módulo, é possível recuperar a estrutura completa de categorias, permitindo uma integração precisa com o Google Merchant Center.

Entidades Envolvidas

Este módulo envolve principalmente a entidade de Categorias do Google, que representa a árvore hierárquica de classificação oficial.

A estrutura é composta por identificadores únicos, nomes descritivos e relacionamentos de parentesco (categorias pai e filhas).

Os dados são servidos a partir de um repositório estático interno que reflete a versão mais recente da taxonomia disponibilizada pelo Google, garantindo alta performance nas consultas e consistência nas informações retornadas.

Notas e Considerações

As rotas deste módulo utilizam o contexto de PublicAuth, o que simplifica o consumo por interfaces administrativas e ferramentas de mapeamento que necessitam de acesso rápido à taxonomia sem exigências de permissões de escrita.

É importante destacar que o mapeamento correto das categorias impacta diretamente na performance de campanhas de Performance Max e Shopping, sendo um requisito fundamental para evitar reprovações de produtos no Merchant Center.

Listagem de Categorias do Google

Descrição

O endpoint de Listagem de Categorias do Google é uma ferramenta essencial para a configuração correta de feeds de produtos para o Google Merchant Center.

Ele permite que o integrador ou lojista visualize a estrutura hierárquica completa de categorias definidas pelo Google Shopping.

Através desta rota, é possível recuperar a árvore recursiva de categorias, facilitando o mapeamento de itens da loja para a taxonomia oficial.

Este mapeamento é fundamental para garantir a relevância das buscas e o desempenho adequado das campanhas de anúncios.

Parâmetros

Headers Obrigatórios

Exemplo de Requisição

1curl --request GET \
2  --url {{MAIN_URL}}/third-party/google/product/categories/all \
3  --header "Authorization: Bearer SEU_TOKEN_AQUI"

✅ Resposta de Sucesso

1[
2  {
3    "id": "1",
4    "name": "Animais e suprimentos para animais de estimação",
5    "children": [
6      {
7        "id": "2",
8        "name": "Alimentos para animais",
9        "children": []
10      }
11    ]
12  },
13  {
14    "id": "166",
15    "name": "Vestuário e acessórios",
16    "children": [
17      {
18        "id": "1604",
19        "name": "Roupas",
20        "children": []
21      }
22    ]
23  }
24]

Busca de Categoria do Google

Descrição

Este endpoint recupera os detalhes de uma categoria da taxonomia oficial do Google Shopping através de seu ID único.

Ele retorna o nome completo da categoria e a estrutura de categorias filhas (children) em primeiro nível para facilitar a navegação hierárquica.

A consulta é fundamental para validar se um identificador de categoria ainda é válido na árvore do Google e para obter o caminho textual completo (breadcrump) da categoria.

Parâmetros

Headers Obrigatórios

Parâmetros da URL

Exemplo de Requisição

1curl --request GET \
2  --url {{MAIN_URL}}/third-party/google/product/categories/123 \
3  --header "Authorization: Bearer SEU_TOKEN_AQUI"

✅ Resposta de Sucesso

1{
2  "id": "123",
3  "name": "Roupas e acessórios > Roupas",
4  "children": [
5    {
6      "id": "456",
7      "name": "Calças",
8      "children": []
9    }
10  ]
11}

⚠️ Possíveis erros:

Atenção: a seguir estão destacados os principais erros que podem ocorrer neste endpoint.

Os cenários descritos representam os erros mais relevantes do contexto atual, servindo como referência para entendimento e tratamento das falhas.