Como verificar dados estruturados JSON-LD numa página Web
Verifique se há erros e campos em falta no JSON-LD de qualquer página Web, veja cada item schema.org que descreve e leia o JSON de cada bloco.
3 min de leitura
Para verificar o JSON-LD de uma página Web, abra o JSON-LD Validator, cole o endereço da página e clique em "Obter e validar JSON-LD". O resultado apresenta todos os problemas, todos os itens descritos pela página e o JSON de cada bloco. Se a página não tiver problemas, o resumo fica verde.
Como verificar uma página
- Abra a página no navegador e copie o endereço da barra de endereço.
- Cole-o no campo URL. Se o endereço não incluir
https://, este é adicionado automaticamente. - Clique em "Obter e validar JSON-LD".
- Leia o resumo acima das tabelas. Indica o número de blocos, erros e avisos.
- Escolha um bloco em Origem para ver o respetivo JSON com números de linha.
Como ler o resultado
- A tabela de problemas apresenta cada erro e aviso. Só aparece quando há algum problema.
- Bloco é o número do bloco de script, contado a partir do início da página.
- Localização indica onde está o problema, como
Product.image. - A tabela de itens apresenta cada item, com o respetivo tipo, como Article ou Product, e o nome.
- Clique no cabeçalho de uma coluna para ordenar uma tabela. Os botões abaixo de cada tabela permitem exportá-la como CSV ou JSON.
Que problemas corrigir primeiro
Os erros aparecem primeiro na lista e têm uma etiqueta vermelha. Os avisos têm uma etiqueta amarela. Um erro significa que algo está avariado ou que falta um campo obrigatório. Os avisos marcados com "(opcional)" referem-se a campos que pode adicionar quando tiver os dados.
Estas mensagens têm soluções simples.
| Mensagem | Solução |
|---|---|
| JSON inválido | Procure uma vírgula ou aspas em falta, ou uma vírgula depois do último valor. |
Falta @context; adicione "@context": "https://schema.org" |
Adicione esta linha ao bloco. |
| Falta @type | Adicione um tipo, como "@type": "Product". |
| "@Type" não é uma palavra-chave JSON-LD | Escreva as palavras-chave em minúsculas: @type. |
| O tipo "Organisation" não é um tipo schema.org válido | Use o nome exato de schema.org: neste caso, Organization. |
| Falta o atributo obrigatório "image" | Adicione o campo indicado na mensagem. |
Quando a verificação não encontra nada ou falha
"Não foram encontrados blocos de script JSON-LD nesta página" significa que o HTML da página não contém JSON-LD. A verificação lê a página tal como é enviada pelo servidor. Não é detetado o JSON-LD que um script adiciona mais tarde no navegador.
"Falha ao obter a página" significa que o site não enviou a página. Isto também acontece quando o endereço redireciona para outro, porque os redirecionamentos não são seguidos. Copie o endereço final da barra de endereço e tente novamente.
Só são verificados os primeiros 3 MB de uma página. Se a página for maior, é apresentada uma mensagem.
Corrija os erros, atualize a página e execute novamente a verificação.
Quer experimentar a ferramenta?
Validador de JSON-LD
Insira uma URL e o servidor buscará a página, extrairá cada bloco de dados estruturados JSON-LD e verificará erros de sintaxe JSON, ausência de @context e @type, tipos e propriedades desconhecidos do schema.org e campos necessários para que o Google exiba resultados avançados.