Notação de objeto JavaScript (JSON)

JSON (JavaScript Object Notation) é um formato de dados leve, baseado em texto, construído a partir de pares chave-valor aninhados e arrays, projetado para representar dados estruturados de uma forma que seja fácil para máquinas analisarem e razoavelmente fácil para uma pessoa ler diretamente. Surgiu do JavaScript, mas agora é independente de linguagem e se tornou o formato padrão para a maioria das APIs da web modernas, substituindo alternativas mais antigas e verbosas para muitos casos de uso de integração. No gerenciamento de feeds, o JSON aparece menos como o formato do próprio feed de compras final e mais como o formato em que tudo relacionado a esse feed é executado.

Por que o JSON é importante para integrações de feeds

A maioria dos feeds de produtos enviados diretamente para um canal de compras ainda são XML ou CSV, mas os sistemas que criam e gerenciam esses feeds — PIMs, ERPs, plataformas de gerenciamento de feeds e as APIs que os conectam — se comunicam entre si predominantemente em JSON. Quando uma ferramenta de gerenciamento de feeds obtém o estoque em tempo real de uma API , verifica o estoque por meio de um payload de webhook ou troca dados com um PIM, esses dados são quase sempre JSON, mesmo que sejam convertidos para XML antes de serem enviados ao Google ou Meta. Compreender o JSON é importante para qualquer pessoa que esteja solucionando problemas de integração de feeds, porque a maior parte da infraestrutura entre os sistemas — e não o arquivo de feed final em si — é onde o JSON realmente reside.

Como funciona o JSON

Um documento JSON é construído a partir de um pequeno conjunto de elementos primitivos: objetos, que são pares chave-valor delimitados por chaves; arrays, que são listas ordenadas delimitadas por colchetes; e valores escalares como strings, números e booleanos. Não há um esquema fixo imposto pelo próprio formato — um analisador JSON não exige um tipo de documento predefinido, o que explica, em parte, seu uso generalizado em respostas de API que precisam evoluir sem quebrar a compatibilidade com clientes mais antigos. Quando uma plataforma de feeds recebe uma carga útil JSON de uma API de feed de dados ou de um webhook, ela normalmente analisa essa estrutura e mapeia seus campos para o formato exigido pelo feed de destino — geralmente XML.

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 tal como existe em JSON, o formato que a maioria das ferramentas de gestão de feeds obtém de uma API, antes de ser convertido nas tags XML que um canal de compras espera.

Conceitos Relacionados

O JSON é o formato de conexão por trás da maior parte da automação da qual os feeds dependem atualmente, seja uma API retornando dados de ações em tempo real ou um webhook enviando uma notificação de alteração de preço no momento em que ela ocorre em um sistema de origem. Ele também aparece cada vez mais como um formato alternativo para o envio de feeds de dados, à medida que mais plataformas adicionam opções de upload baseadas em JSON, além do suporte tradicional a XML e CSV.