O JSON (JavaScript Object Notation) é um formato de dados leve, baseado em texto, construído a partir de pares chave-valor e arrays aninhados, projetado para representar dados estruturados de uma forma fácil de ser interpretada por máquinas e razoavelmente fácil de ser lida diretamente por uma pessoa. Ele surgiu do JavaScript, mas hoje é independente de linguagem e se tornou o formato padrão da maioria das APIs web modernas, substituindo alternativas mais antigas e verbosas em muitos casos de integração. Na gestão de feeds, o JSON aparece menos como o formato do feed de shopping final em si e mais como o formato sobre o qual tudo ao redor desse feed funciona cada vez mais.
Por que o JSON é importante para integrações de feed
A maioria dos feeds de produtos enviados diretamente a um canal de shopping ainda é XML ou CSV, mas os sistemas que criam e gerenciam esses feeds — PIMs, ERPs, plataformas de gestão de feeds e as APIs que conectam todos eles — se comunicam entre si predominantemente em JSON. Quando uma ferramenta de gestão de feeds obtém o estoque em tempo real de uma API, verifica o estoque por meio do payload de um webhook ou troca dados com um PIM, esses dados são quase sempre JSON por baixo, mesmo que sejam convertidos em XML antes de serem enviados ao Google ou à Meta. Entender JSON é importante para quem precisa solucionar problemas em uma integração de feed, porque é na maior parte da infraestrutura entre os sistemas — e não no arquivo de feed final em si — que o JSON realmente está.
Como o JSON funciona
Um documento JSON é construído a partir de um pequeno conjunto de elementos básicos: objetos, que são pares chave-valor entre chaves, arrays, que são listas ordenadas entre colchetes, e valores escalares como strings, números e booleanos. Não há um schema fixo imposto pelo próprio formato — um parser de JSON não exige um tipo de documento predefinido, o que é parte do motivo pelo qual ele é tão usado em respostas de API que precisam evoluir sem quebrar clientes mais antigos. Quando uma plataforma de feeds recebe um payload JSON de uma API de data feed ou de um webhook, ela normalmente interpreta essa estrutura e mapeia seus campos para o que o formato de feed de destino — muitas vezes XML — realmente exige.
Exemplo: dados JSON por trás de um item de feed XML
<!--
Source payload from the merchant's API, before conversion:
{
"sku": "SKU-51290",
"title": "Recycled Denim Tote Bag",
"price": { "amount": 38.00, "currency": "USD" },
"availability": "in_stock"
}
-->
<item>
<g:id>SKU-51290</g:id>
<title>Recycled Denim Tote Bag</title>
<g:price>38.00 USD</g:price>
<g:availability>in stock</g:availability>
</item>O bloco comentado mostra o mesmo produto como ele existe em JSON, o formato que a maioria das ferramentas de gestão de feeds realmente obtém de uma API, antes de ser convertido nas tags XML que um canal de shopping espera.
Conceitos relacionados
O JSON é o formato de conexão por trás da maior parte da automação da qual os feeds dependem hoje, seja uma API retornando dados de estoque em tempo real, seja um webhook enviando uma alteração de preço no momento em que ela acontece no sistema de origem. Ele também aparece cada vez mais como formato alternativo de envio do próprio data feed, à medida que mais plataformas adicionam opções de upload baseadas em JSON além do tradicional suporte a XML e CSV.
