Como os campos recebem significado
O JSON-LD é uma sintaxe baseada em JSON para representar informações ligadas. O nome vem de JSON for Linked Data. Ele permite associar os nomes dos campos a um vocabulário e identificar entidades por endereços, para que sistemas interpretem suas propriedades e relações.
Um JSON comum pode ter um campo name sem informar se ele nomeia um livro ou seu autor. No JSON-LD, a palavra-chave @context define como interpretar termos como name e author. A palavra-chave @type informa o tipo da entidade descrita.
Um livro relacionado ao autor
Este exemplo didático usa o vocabulário Schema.org para descrever um livro fictício e relacioná-lo a um autor também fictício:
{ "@context": "https://schema.org", "@type": "Book", "@id": "https://example.org/livros/exemplo", "name": "Guia de exemplo", "author": { "@type": "Person", "@id": "https://example.org/autores/ana", "name": "Ana" }}O primeiro name pertence ao livro. O segundo pertence à entidade Person, associada ao livro pela propriedade author. Os valores de @id identificam as duas entidades, enquanto @context associa os termos ao vocabulário escolhido.
Você pode ler a estrutura com um parser de JSON, mas a interpretação das relações exige considerar o vocabulário declarado. Em uma página web, a marcação precisa descrever o conteúdo correspondente para atender às diretrizes do Google. O fragmento descreve o livro e o autor, mas não reúne todas as exigências de um recurso de busca específico.
Dúvidas frequentes
Perguntas frequentes sobre JSON-LD
- Um JSON válido já descreve o significado dos campos?
- Um parser de JSON lê o campo name e seu valor sem determinar se o nome pertence a um livro ou a um autor. No JSON-LD do exemplo, os tipos Book e Person e a relação author tornam essa associação explícita.
- O JSON-LD serve somente para a busca do Google?
- O JSON-LD é um padrão do W3C para representar informações ligadas e pode ser usado na troca de informações entre sistemas. A marcação para buscadores é uma aplicação desse padrão.
- É obrigatório usar Schema.org com JSON-LD?
- O JSON-LD admite outros vocabulários e definições de termos. Para uso na busca do Google, você precisa seguir o vocabulário e as propriedades indicados na documentação do recurso pretendido.
Para continuar
Recursos relacionados
Documentação
W3C: representação JSON-LD 1.1
Especificação JSON-LD 1.1 do W3C, com a definição das palavras-chave e exemplos de associação entre entidades.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Sessão prática para você revisar o JSON-LD gerado pela aplicação e investigar sua integração com o conteúdo do site.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O desenvolvimento com agentes exige compreender o comportamento da aplicação e conferir o resultado das alterações.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.