Dados estruturados de exercícios (Quiz)

Para ajudar alunos, professores e pais a encontrar materiais de ensino e de aprendizagem on-line mais facilmente, use dados estruturados para marcar os exercícios. Neste guia, explicamos como implementar esse esquema na página da Web. A adição de dados estruturados qualifica os exercícios para exibição em uma experiência do usuário especial nos resultados da Pesquisa Google.

Pesquisa aprimorada de exercícios na Pesquisa Google

Como adicionar dados estruturados

Os dados estruturados são um formato padronizado para fornecer informações sobre uma página e classificar o conteúdo dela. Caso você não saiba muito sobre o assunto, veja como os dados estruturados funcionam.

Esta é uma visão geral de como criar, testar e lançar dados estruturados.

  1. Adicione as propriedades obrigatórias. Com base no formato que você está usando, saiba onde inserir dados estruturados na página.
  2. Siga as diretrizes.
  3. Valide o código com o Teste de pesquisa aprimorada e corrija os erros críticos. Corrija também os problemas não críticos que possam ser sinalizados na ferramenta, porque eles podem melhorar a qualidade dos dados estruturados, mas isso não é necessário para se qualificar para pesquisas aprimoradas.
  4. Implante algumas páginas que incluam os dados estruturados e use a Ferramenta de inspeção de URL para testar como o Google vê a página. Verifique se a página está acessível ao Google e se não está bloqueada por um arquivo robots.txt, pela tag noindex ou por requisitos de login. Se estiver tudo certo, peça ao Google para rastrear novamente seus URLs.
  5. Para informar o Google sobre mudanças futuras, recomendamos que você envie um sitemap. É possível automatizar isso com a API Search Console Sitemap.

Disponibilidade do recurso

O recurso de exercício está disponível em inglês em todas as regiões em que a Pesquisa Google está disponível. Esse recurso está disponível somente para tópicos de matemática e ciências, com tipos de pergunta de múltipla escolha e caixas de seleção, em computadores e dispositivos móveis.

Exemplos

Teste com somente uma pergunta

Veja um exemplo de teste com somente uma pergunta associada a ele. Há só uma resposta correta.

<html>
  <head>
    <title>Quiz about fractions</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Quiz",
      "name": "Quiz about fractions",
      "hasPart": {
        "@type": "Question",
        "typicalAgeRange": "7-12",
        "educationalAlignment": [
          {
            "@type": "AlignmentObject",
            "alignmentType": "educationalSubject",
            "targetName": "Mathematics"
          },
          {
            "@type": "AlignmentObject",
            "alignmentType": "educationalSubject",
            "targetName": "Algebra"
          },
          {
            "@type": "AlignmentObject",
            "alignmentType": "educationalLevel",
            "targetName": "Grade 5 » Number and Operations—Fractions » Apply and extend previous understandings of multiplication and division. » 3",
            "educationalFramework": "Common Core",
            "targetUrl": "https://www.corestandards.org/Math/Content/5/NF/B/3/"
          }
        ],
        "about": {
          "@type": "Thing",
          "name": "Fractions"
        },
        "educationalLevel": "intermediate",
        "eduQuestionType": "Multiple choice",
        "learningResourceType": "Practice problem",
        "assesses": "Multiplying fractions by whole numbers",
        "name": "Choose the model",
        "comment": {
          "@type": "Comment",
          "text": "This is a hint about the question."
        },
        "encodingFormat": "text/markdown",
        "text": "Which model represents the product $$2 * \\frac{2}{3}$$?",
        "suggestedAnswer": [
          {
            "@type": "Answer",
            "position": 0,
            "encodingFormat": "text/html",
            "text": "<img src=\"www.test.com/practice-problems-fractions/…image2.png\" alt=\"Answer 2\" />",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint about the answer."
            }
          }
        ],
        "acceptedAnswer": {
          "@type": "Answer",
          "position": 1,
          "encodingFormat": "text/html",
          "text": "<img src=\"www.test.com/practice-problems-fractions/…image1.png\" alt=\"Answer 1\" />",
          "comment": {
            "@type": "Comment",
            "text": "This is a hint about the answer."
          },
          "answerExplanation": {
            "@type": "Comment",
            "text": "This is a full explanation on how this answer was achieved."
          }
        }
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Teste com somente uma pergunta e respostas em caixas de seleção

Veja um exemplo de teste com somente uma pergunta associada a ele. Há várias respostas corretas.

<html>
  <head>
    <title>Quiz about laws of Physics</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Quiz",
      "name": "Quiz about laws of physics",
      "about": {
        "@type": "Thing",
        "name": "Laws of Physics And Applications"
      },
      "educationalLevel": "intermediate",
      "assesses": "Laws of physics",
      "hasPart": {
        "@type": "Question",
        "eduQuestionType": "Checkbox",
        "learningResourceType": "Practice problem",
        "name": "Laws of Physics And Applications",
        "typicalAgeRange": "12-15",
        "text": "Identify laws of Physics. (Select all valid answers)",
        "suggestedAnswer": [
          {
            "@type": "Answer",
            "position": 0,
            "text": "Nevada's Law",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            }
          },
          {
            "@type": "Answer",
            "position": 2,
            "text": "EUA law",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            }
          }
        ],
        "acceptedAnswer": [
          {
            "@type": "Answer",
            "position": 1,
            "text": "Newton's law",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            },
            "answerExplanation": {
              "@type": "Comment",
              "text": "This is a full explanation on how this answer was achieved."
            }
          },
          {
            "@type": "Answer",
            "position": 3,
            "text": "Ohm's law",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            },
            "answerExplanation": {
              "@type": "Comment",
              "text": "This is a full explanation on how this answer was achieved."
            }
          }
        ]
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Teste com várias perguntas

Veja um exemplo de um teste com vários pares de perguntas e respostas.

<html>
  <head>
    <title>Quiz about displacement, velocity and time</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Quiz",
      "typicalAgeRange": "7-12",
      "educationalLevel": "intermediate",
      "assesses": "Velocity and speed",
      "educationalAlignment": [
        {
          "@type": "AlignmentObject",
          "alignmentType": "educationalSubject",
          "targetName": "Science"
        },
        {
          "@type": "AlignmentObject",
          "alignmentType": "educationalSubject",
          "targetName": "Physics"
        }
      ],
      "name": "Quiz about displacement, velocity and time",
      "about": {
        "@type": "Thing",
        "name": "Displacement, velocity, and time"
      },
      "hasPart": [
        {
          "@type": "Question",
          "eduQuestionType": "Multiple choice",
          "learningResourceType": "Practice problem",
          "name": "Average velocity and average speed from graphs",
          "text": "A bug crawls on a wall. What is the average velocity of the bug between the times $$t = 1s$$ and $$t = 10s$$?",
          "comment": {
            "@type": "Comment",
            "text": "This is a hint about the question."
          },
          "encodingFormat": "text/markdown",
          "suggestedAnswer": [
            {
              "@type": "Answer",
              "position": 0,
              "encodingFormat": "text/markdown",
              "text": "$$0.5 \\frac{m}{s}$$",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            },
            {
              "@type": "Answer",
              "position": 1,
              "encodingFormat": "text/markdown",
              "text": "$$-0.5 \\frac{m}{s}$$",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            },
            {
              "@type": "Answer",
              "position": 3,
              "encodingFormat": "text/markdown",
              "text": "$$1.5 \\frac{m}{s}$$",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            }
          ],
          "acceptedAnswer": {
            "@type": "Answer",
            "position": 2,
            "encodingFormat": "text/markdown",
            "text": "$$0 \\frac{m}{s}$$",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            }
          }
        },
        {
          "@type": "Question",
          "eduQuestionType": "Multiple choice",
          "learningResourceType": "Practice problem",
          "name": "Average velocity and average speed from graphs",
          "text": "A swimmer motion is shown on the following graph of position x vs. time t. What is the average speed?",
          "encodingFormat": "text/markdown",
          "comment": {
            "@type": "Comment",
            "text": "This is a hint about the question."
          },
          "suggestedAnswer": [
            {
              "@type": "Answer",
              "position": 0,
              "text": "1",
              "encodingFormat": "text/html",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            },
            {
              "@type": "Answer",
              "position": 2,
              "text": "3",
              "encodingFormat": "text/html",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            },
            {
              "@type": "Answer",
              "position": 3,
              "text": "4",
              "encodingFormat": "text/html",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            }
          ],
          "acceptedAnswer": {
            "@type": "Answer",
            "position": 1,
            "text": "2",
            "encodingFormat": "text/html",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            },
            "answerExplanation": {
              "@type": "Comment",
              "text": "This is a full explanation on how this answer was achieved."
            }
          }
        }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Diretrizes

Se quiser qualificar o conteúdo para exibição na experiência de exercícios do Google, siga estas diretrizes:

Diretrizes técnicas

  • Coloque os dados estruturados na página de detalhes da forma mais descritiva possível. Não adicione dados estruturados a páginas sem exercícios.
  • Adicione uma propriedade Quiz para cada exercício que você quer exibir. Os dados estruturados precisam aparecer na mesma página da Web do exercício com que o usuário pode interagir.
  • Sua página da Web precisa incluir todas as propriedades de dados estruturados obrigatórias.
  • Marque no mínimo dois exercícios para cada tópico (por exemplo, dois exercícios para o conceito "equação do 2º grau"). Concentre-se em marcar conceitos e problemas que você quer que sejam qualificados para aparecer na pesquisa aprimorada de exercícios. Eles podem estar em páginas separadas.
  • Os exercícios no site precisam ser acessíveis aos usuários, ou seja, não podem ser mantidos somente em um arquivo de dados ou PDF.
  • Confira se o Googlebot pode rastrear seu site de modo eficiente.
  • Se você tiver várias cópias do mesmo exercício no site hospedadas em URLs diferentes, use URLs canônicos em cada uma delas.
  • Para exercícios somente de texto:
    • a pergunta precisa ter no máximo 320 caracteres;
    • as respostas de múltipla escolha precisam ter no máximo 70 caracteres por resposta.
  • Para exercícios com texto e imagem:
    • a pergunta precisa ter no máximo 160 caracteres;
    • a altura máxima da imagem precisa ser de 200 px.
  • Acessibilidade: não permitimos exercícios ocultos por um login ou paywall. Quando os usuários acessam o recurso no Google para seu site, o conteúdo do exercício precisa estar acessível a eles. Conteúdo adicional pode ser protegido por login ou paywall.
  • Declarações falsas: não permitimos exercícios com o objetivo de enganar os usuários. Isso inclui a marcação imprecisa de tópicos não associados à pergunta.

Diretrizes de conteúdo

Criamos estas diretrizes de conteúdo de exercícios para garantir que nossos usuários encontrem recursos de aprendizado relevantes. Se encontrarmos conteúdo que viole essas políticas, responderemos adequadamente. Isso pode incluir ações manuais e a remoção das suas páginas da experiência de exercícios do Google.

Linguagem obscena e vulgar

Não permitimos exercícios com linguagem obscena, profana ou ofensiva.

Anúncios disfarçados de exercícios

Não permitimos conteúdo promocional disfarçado de exercício, como aqueles postados por terceiros (por exemplo, programas de afiliados).

Se o Google receber uma reclamação de que o conteúdo de um exercício pode violar a lei, o conteúdo será tratado de acordo com as políticas da Pesquisa.

Qualidade

  • Você é responsável pela precisão e qualidade dos exercícios oferecidos com esse recurso. Se uma determinada quantidade de dados for considerada imprecisa com base nos nossos processos de avaliação de qualidade, talvez todos ou alguns dos exercícios sejam removidos do recurso até que os problemas sejam resolvidos, dependendo da gravidade. Isso se aplica à precisão dos seguintes elementos:
    • O conceito marcado como relacionado à pergunta
    • A formatação e precisão das perguntas, respostas escolhidas, dicas e explicações de respostas
    • A ordem correta das respostas (por exemplo, não coloque "Nenhuma das opções" como a primeira opção)
    • A qualidade e a precisão das imagens ou fórmulas relacionadas à pergunta
    • A renderização de símbolos matemáticos e a implementação de delimitadores

Marcar padrões educacionais

Os padrões de aprendizagem são as metas de aprendizagem que os alunos precisam conhecer e saber fazer em cada série. Os padrões de aprendizado têm vários usos, como vincular conteúdo ou fazer parte de uma progressão de aprendizagem. Marcar os padrões (encontrados nos campos educationalAlignment e hasPart.educationalAlignment) associados ao material de aprendizado on-line ajuda o Google a organizar e exibir informações de maneira mais útil para as pessoas que pesquisam conteúdo com base nesses padrões. Confira uma visão geral de alto nível do esquema:

Veja alguns exemplos de padrões:

  • Common Core State Standards
  • Texas Essential Knowledge and Skills (TEKS)
  • Virginia Standards of Learning (SOL)
  • BC Performance Standards
  • Alberta Programs of Studies
  • The Australian Curriculum (ACARA)
  • The Victorian Curriculum (F-10)
  • UK National Curriculum

Definições de tipos de dados estruturados

É necessário incluir as propriedades obrigatórias para que o conteúdo seja qualificado para exibição como uma pesquisa aprimorada. Também é possível incluir as propriedades recomendadas para adicionar mais informações aos seus dados estruturados, o que pode proporcionar uma melhor experiência do usuário.

Quiz

Um Quiz é um agrupamento de exercícios (um ou mais), geralmente sobre o mesmo conceito ou assunto.

Veja a definição completa de Quiz no site schema.org (em inglês).

Propriedades obrigatórias
about Thing

São informações aninhadas sobre o conceito fundamental de Quiz. Se houver uma propriedade hasPart.about para a pergunta, essa propriedade não é obrigatória.

{
  "@type": "Quiz",
  "about": {
    "@type": "Thing"
  }
}
about.name Text

São informações aninhadas sobre o conceito fundamental de Quiz. Se houver uma propriedade hasPart.about.name para a pergunta, essa propriedade não é obrigatória. São permitidas várias entradas dessa propriedade.

{
  "@type": "Quiz",
  "about": {
    "@type": "Thing",
    "name": "Fractions"
  }
}
hasPart Question

São informações aninhadas sobre o exercício específico do teste. Use uma propriedade hasPart para representar um único exercício.

Para incluir vários exercícios em um único teste, repita essa propriedade.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question"
  }
}
hasPart.acceptedAnswer Answer

É a resposta correta à pergunta. Se houver várias respostas corretas para uma única pergunta, repita essa propriedade.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "acceptedAnswer": {
      "@type": "Answer"
    }
  }
}
hasPart.eduQuestionType Text

É o tipo de exercício. Isso é fundamental para a Pesquisa Google renderizar e verificar as respostas corretas e incorretas. Para cada pergunta, o Google exibe no mínimo duas e no máximo seis respostas.

Use um dos valores aceitos:

  • Multiple choice: há só uma resposta correta. As opções são exibidas como um conjunto de botões de opção, e o usuário só pode selecionar um deles.
  • Checkbox: há mais de uma resposta correta. As opções são mostradas como um conjunto de caixas de seleção, e o usuário pode marcar todas as opções válidas.
{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "eduQuestionType": "Multiple choice"
  }
}
hasPart.learningResourceType Text

É o tipo desse recurso de aprendizado. Use este valor fixo: Practice problem.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "learningResourceType": "Practice problem"
  }
}
hasPart.suggestedAnswer Answer

São todas as outras respostas corretas ou incorretas para a pergunta. Para especificar várias respostas, repita essa propriedade com as respectivas propriedades aninhadas.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
    }
  }
}
hasPart.suggestedAnswer.text Text

É o conteúdo da resposta. É possível usar Markdown ou HTML. Saiba como codificar exercícios em HTML ou Markdown.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "text": "$$x = 1$$"
    }
  }
}
hasPart.text Text

É o conteúdo da pergunta. É possível usar Markdown ou HTML. Saiba como codificar exercícios em HTML ou Markdown.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "text": "Which diagram represents the product $$3 *\frac{2}{3}$$?"
  }
}
Propriedades recomendadas
educationalAlignment AlignmentObject

É o alinhamento do teste com um framework educacional estabelecido. A propriedade pode ser repetida para alinhar o teste a uma área ou domínio de estudo e à série ou ao padrão educacional indicado. Você pode adicionar alinhamentos educacionais diretamente em Quiz ou mais especificamente em Question.

{
  "@type": "Quiz",
  "educationalAlignment": []
}
educationalAlignment.alignmentType Text

É uma categoria de alinhamento entre o recurso de aprendizado e o nó do framework do teste. A Pesquisa Google usa o padrão LRMI.

Repita alignmentType para especificar a área de estudo e a série ou o padrão educacional indicado.

  • Para especificar a área ou o domínio de estudo do teste, defina alignmentType como educationalSubject.
  • Para especificar a série ou o padrão educacional indicado do teste, defina alignmentType como educationalLevel.

No caso de outros domínios e subdomínios, é possível inserir vários objetos. Para especificar conceitos, use a propriedade about.

Veja como especificar educationalSubject e educationalLevel.

{
  "@type": "Quiz",
  "educationalAlignment": [
    {
      "@type": "AlignmentObject",
      "alignmentType": "educationalSubject",
      "targetName": "Mathematics"
    },
    {
      "@type": "AlignmentObject",
      "alignmentType": "educationalLevel",
      "targetName": "Fifth grade"
    }
  ]
}

Para fazer referência a padrões como o "Common Core", use as propriedades educationalAlignment.educationalFramework e educationalAlignment.targetUrl .

{
  "@type": "Quiz",
  "educationalAlignment: [
  {
    "@type": "AlignmentObject",
    "alignmentType": "educationalLevel",
    "educationalFramework": "Common Core",
    "targetName": "Grade 8: Expressions and Equations",
    "targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/"
    }
  ]
}
educationalAlignment.educationalFramework Text

É o framework a que o teste está alinhado. Por exemplo, "Common Core". Para mais informações sobre por que essa propriedade é importante, consulte Marcar padrões educacionais. São permitidas várias entradas dessa propriedade.

educationalAlignment.targetName Text

É o nome de um nó de um framework educacional estabelecido. Por exemplo: "8.ª série: expressões e equações".

{
  "@type": "Quiz",
  "educationalAlignment: [
  {
    "@type": "AlignmentObject",
    "targetName": "Grade 8: Expressions and Equations"
    }
  ]
}
educationalAlignment.targetUrl URL

É o URL do framework educacional específico. Por exemplo, o URL do padrão Common Core para matemática da 8.ª série.

{
  "@type": "Quiz",
  "educationalAlignment: [
  {
    "@type": "AlignmentObject",
    "targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/"
    }
  ]
}
educationalLevel Text

É o nível de dificuldade do teste. Veja alguns exemplos de valores que podem ser usados:

  • beginner
  • intermediate
  • advanced
{
  "@type": "Quiz",
  "educationalLevel": "beginner"
}
hasPart.about Thing

São informações aninhadas sobre o conceito fundamental da pergunta. Se a propriedade about não for especificada para Quiz, hasPart.about será obrigatória. São permitidas várias entradas dessa propriedade.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "about": {
      "@type": "Thing"
    }
  }
}
hasPart.about.name Text

É o título do conceito fundamental da pergunta. Se a propriedade about.name não for especificada para Quiz, hasPart.about.name será obrigatória.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "about": {
      "@type": "Thing",
      "name": "Fractions"
    }
  }
}
hasPart.acceptedAnswer.answerExplanation Comment

É uma explicação completa sobre como chegar ao resultado apresentado nesta resposta. Geralmente, ela só é usada para respostas corretas. Use a propriedade hasPart.suggestedAnswer.comment.text no conteúdo da explicação.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "acceptedAnswer": {
      "@type": "Answer",
      "answerExplanation": {
        "@type": "Comment"
       }
    }
  }
}
hasPart.acceptedAnswer.answerExplanation.text Text

É o conteúdo da explicação da resposta sugerida. Para mudar o formato do conteúdo (HTML ou Markdown), use encodingFormat. Saiba como codificar exercícios em HTML ou Markdown.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "answerExplanation": {
        "@type": "Comment",
        "text": "*In order to get to this result..*",
        "encodingFormat": "text/markdown"
       }
    }
  }
}
hasPart.acceptedAnswer.comment Comment

É uma dica ou sugestão sobre a resposta que pode ser usada para entender por que ela está correta. Use a propriedade hasPart.acceptedAnswer.comment.text para o conteúdo da dica.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "acceptedAnswer": {
      "@type": "Answer",
      "comment": {
        "@type": "Comment"
      }
    }
  }
}
hasPart.acceptedAnswer.comment.text Text

É o conteúdo da dica ou sugestão da resposta sugerida. Para mudar o formato do conteúdo (HTML ou Markdown), use encodingFormat. Saiba como codificar exercícios em HTML ou Markdown.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "acceptedAnswer": {
      "@type": "Answer",
      "comment": {
        "@type": "Comment",
        "text": "<p>This is a hint</p>"
      }
    }
  }
}
hasPart.acceptedAnswer.position Integer

É a posição dessa resposta quando ela é exibida para o usuário.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "acceptedAnswer": {
      "@type": "Answer",
      "position": "2"
    }
  }
}
hasPart.assesses DefinedTerm ou Text

São as habilidades necessárias para resolver o problema. Preencher essas informações pode melhorar a capacidade de descoberta.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "assesses": "Multiplying fractions by whole numbers"
  }
}
hasPart.comment Comment

É uma dica ou sugestão sobre a pergunta que pode ser usada para resolvê-la. Use a propriedade hasPart.comment.text para o conteúdo da dica.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "comment": {
      "@type": "Comment"
    }
  }
}
hasPart.comment.text Text

É o conteúdo da dica ou sugestão da pergunta. Para mudar o formato do conteúdo (HTML ou Markdown), use encodingFormat. Saiba como codificar exercícios em HTML ou Markdown.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "comment": {
      "@type": "Comment",
      "text": "<p>This is a hint</p>"
    }
  }
}
hasPart.educationalAlignment AlignmentObject

É o alinhamento da pergunta com um framework educacional estabelecido. Esta propriedade modifica alinhamentos educacionais adicionados ao objeto Quiz.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "educationalAlignment": []
}
hasPart.educationalAlignment.alignmentType Text

É uma categoria de alinhamento entre o recurso de aprendizado e o nó do framework da pergunta. A Pesquisa Google usa o padrão LRMI.

Repita alignmentType para especificar a área de estudo e a série ou o padrão educacional indicado.

  • Para especificar a área ou o domínio de estudo da pergunta, defina alignmentType como educationalSubject.
  • Para especificar a série ou o padrão educacional indicado da pergunta, defina alignmentType como educationalLevel.

No caso de outros domínios e subdomínios, é possível inserir vários objetos. Para especificar conceitos, use a propriedade hasPart.about.

Veja como especificar educationalSubject e educationalLevel.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "educationalAlignment": [
      {
      "@type": "AlignmentObject",
      "alignmentType": "educationalSubject",
      "targetName": "Mathematics"
      },
      {
      "@type": "AlignmentObject",
      "alignmentType": "educationalLevel",
      "targetName": "Fifth grade"
      }
    ]
  }
}

Para fazer referência a padrões como o "Common Core", use as propriedades hasPart.educationalAlignment.educationalFramework e hasPart.educationalAlignment.targetUrl.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "educationalAlignment: [
      {
      "@type": "AlignmentObject",
      "alignmentType": "educationalLevel",
      "educationalFramework": "Common Core",
      "targetName": "Grade 8: Expressions and Equations",
      "targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/"
      }
    ]
  }
}
hasPart.educationalAlignment.educationalFramework Text

É o framework a que a pergunta está alinhada. Por exemplo, "Common Core". Para mais informações sobre por que essa propriedade é importante, consulte Marcar padrões educacionais. São permitidas várias entradas dessa propriedade.

hasPart.educationalAlignment.targetName Text

É o nome de um nó de um framework educacional estabelecido. Por exemplo: "8.ª série: expressões e equações".

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "educationalAlignment: [
      {
      "@type": "AlignmentObject",
      "alignmentType": "educationalLevel",
      "targetName": "Grade 8: Expressions and Equations"
      }
    ]
  }
}
hasPart.educationalAlignment.targetUrl URL

É o URL do framework educacional específico que se aplica à pergunta. Por exemplo, o URL do padrão Common Core para matemática da 8ª série.

hasPart.educationalLevel Text

É o nível de dificuldade da pergunta, em formato de texto. Veja alguns exemplos de valores que podem ser usados:

  • beginner
  • intermediate
  • advanced
{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "educationalLevel": "beginner"
  }
}
hasPart.name Text

É uma descrição geral da pergunta. Não inclua o conteúdo completo da pergunta. Use hasPart.text.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "name": "Question about fractions"
  }
}
hasPart.suggestedAnswer.comment Comment

É uma dica ou sugestão sobre a resposta que pode ser usada para entender por que ela está certa ou errada. Use a propriedade hasPart.suggestedAnswer.comment.text para o conteúdo da dica.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "comment": {
        "@type": "Comment"
      }
    }
  }
}
hasPart.suggestedAnswer.comment.text Text

É o conteúdo da dica ou sugestão da resposta sugerida. Para mudar o formato do conteúdo (HTML ou Markdown), use encodingFormat. Saiba como codificar exercícios em HTML ou Markdown.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "comment": {
        "@type": "Comment",
        "text": "<p>This is a hint</p>"
      }
    }
  }
}
hasPart.suggestedAnswer.encodingFormat Text

É o formato MIME usado para codificar a propriedade de texto. Se nenhum encodingFormat for especificado, o valor padrão será text/html. Use um dos seguintes valores:

  • text/markdown
  • text/html
{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "encodingFormat": "text/html"
    }
  }
}

Saiba como codificar exercícios em HTML ou Markdown.

hasPart.suggestedAnswer.position Integer

É a posição dessa resposta quando exibida ao usuário.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "position": "0"
    }
  }
}
hasPart.typicalAgeRange Text

É a faixa etária típica a que a pergunta se destina. Por exemplo, 7-12 ou 18-.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "typicalAgeRange": "7-12"
  }
}
name Text

É o título do teste.

{
  "@type": "Quiz",
  "name": "Negative exponents review"
}
typicalAgeRange Text

É a faixa etária típica a que o teste se destina. Por exemplo, 7-12 ou 18-.

{
  "@type": "Quiz",
  "typicalAgeRange": "7-12"
}

Codificação de exercícios em HTML ou Markdown

A Pesquisa Google é compatível com Markdown (CommonMark) e HTML para codificar Question, Answer e Comment. Restringimos o conjunto de elementos aos seguintes:

  • Cabeçalhos
  • Quebras de linha
  • Listas ordenadas e não ordenadas
  • Parágrafos
  • Negrito
  • Itálico
  • Imagens
  • Fórmulas em LaTex

CSS ou JavaScript são ignorados. O Google não exibirá perguntas que contenham tags HTML não compatíveis.

Como especificar o formato

Para especificar qual formato de codificação você está usando, use a propriedade encodingFormat e defina o valor como "text/html" para HTML ou "text/markdown" para Markdown.

Veja um exemplo de pergunta definida para o formato Markdown:

{
  "@type": "Question",
  "name": "Average velocity and average speed from graphs",
  "text": "What is the average velocity [..] between the times $$t = 4s$$ and $$t = 10s$$?",
  "encodingFormat": "text/markdown"
  ..
  ..
}

Se nenhum encodingFormat for especificado, "text/html" será usado.

Fórmulas

Para especificar uma fórmula, use o formato LaTex. Você precisa usar o cifrão duplo ($$) to embed formulas. For example:

"<p>Please solve: $$2x^2 = 18$$</p>"
    ).

Solução de problemas

Se você tiver problemas para implementar ou depurar dados estruturados, veja alguns recursos que podem ajudar.