Gerenciar metas de aprendizado

Os usuários podem definir metas de aprendizado para cursos e atividades no Google Sala de Aula. As mesmas metas de aprendizado também são expostas na API Classroom. É possível definir, recuperar e modificar conjuntos de padrões de aprendizado em recursos Course e metas de aprendizado em recursos CourseWork, CourseWorkMaterial e Rubric. Este guia descreve como acessar e modificar metas de aprendizado e conjuntos de padrões usando a API Classroom.

Como funciona

Fonte de dados

As metas de aprendizado no Google Sala de Aula dependem de identificadores globais exclusivos (GUIDs, na sigla em inglês) fornecidos pelo Satchel Rosetta Exchange (antigo CASE Network). Os padrões no Exchange são organizados em árvores de nós, em que a raiz é um repositório curricular abrangente para uma matéria específica, e os nós filhos descrevem resultados de aprendizado progressivamente mais específicos. O identificador de qualquer nó com um código padrão ou nó folha na rede pode ser definido como uma meta de aprendizado em um CourseWork, enquanto qualquer nó não folha pode ser definido como um conjunto de padrões de aprendizado em um Course.

  • Os conjuntos de padrões de aprendizado para um Course recurso representam o grupo de padrões que aparecem na interface do Google Sala de Aula quando os professores marcam metas de aprendizado.
  • As metas de aprendizado anexadas a um CourseWork, CourseWorkMaterial, ou Rubric recurso representam o padrão ou as habilidades associadas a essa atividade, pergunta, material, ou critério de rubrica específico.

O Google usa cinco informações do Satchel Rosetta Exchange:

  • ID do documento: um GUID para um nó de nível raiz. Esse ID corresponde a um contêiner de padrões de nível superior e é comum a todos os nós filhos.
  • Título do documento: o nome legível de todo o documento padrão.
  • ID do item: um GUID para um único padrão (ou seja, um nó não raiz).
  • Título padrão: o texto descritivo legível de um único padrão.
  • Código padrão: uma abreviação legível para um padrão específico.

Encontrar valores para padrões e metas

Para entender onde encontrar esses valores, considere um exemplo de padrão de matemática do estado de Nova York. Comece no nó raiz:

Visualização de um nó raiz quando selecionado no Satchel Rosetta Exchange Figura 1: visualização de um nó raiz quando selecionado no Satchel Rosetta Exchange. Isso mostra o título e o ID do documento, que são comuns a todos os nós nesta página.

Na visualização da Figura 1, é possível extrair os seguintes valores:

  • ID do documento: c649d172-d7cb-11e8-824f-0242ac160002
  • Título do documento: New York State Next Generation Mathematics Learning Standards

Para receber valores de um padrão individual, clique em um padrão e expanda os metadados dele:

Visualização dos metadados de um nó não raiz quando selecionado no Satchel Rosetta Exchange Figura 2: visualização dos metadados de um nó não raiz quando selecionado no Satchel Rosetta Exchange. Isso mostra o ID do item, o código padrão e o título padrão. Esses valores são específicos apenas para esse padrão.

Na visualização da Figura 2, é possível encontrar os seguintes valores:

  • ID do item: 70d64c79-d7cc-11e8-824f-0242ac160002
  • Título padrão: Understand that the digits of a three-digit number represent amounts of hundreds, tens, and ones.
  • Código padrão: NY-2.NBT.4

Os IDs de documentos e itens também podem ser extraídos do URL do Satchel Rosetta Exchange de cada nó. Esses URLs seguem o padrão https://rosetta.commongoodlt.com/{document_id}/{item_id}.

Número máximo de itens vinculados

  • Cada Course pode ter até cinco conjuntos de padrões de aprendizado.
  • Cada CourseWork pode ter até 10 metas de aprendizado.
  • Cada Criterion de rubrica pode ter uma meta de aprendizado.

Gerenciar conjuntos de padrões de aprendizado do curso

Modificar conjuntos de padrões de aprendizado

Para modificar conjuntos de padrões de aprendizado Course, preencha o campo Course.learningStandardSettings com objetos standardSets. Cada standardSet precisa conter um objeto caseGuid, que inclui um caseDocumentId e, opcionalmente, um caseItemId.

É possível adicionar conjuntos de padrões de aprendizado usando qualquer Course solicitação de mutação, como courses.create() ou courses.patch() com a máscara de atualização learningStandardSettings.

O exemplo a seguir define dois conjuntos de padrões em um curso existente.

Python

service = build("classroom", "v1", credentials=creds)
course = {
    "learningStandardSettings": {
        # Each Course can have up to 5 learning standard sets.
        "standardSets": [
            # Construct a GUID for the NYS Next Gen Math Standards top-level node.
            # This is a top-level non-leaf node, so it only has a Document ID.
            {
                "caseGuid": {
                    "caseDocumentId": "c649d172-d7cb-11e8-824f-0242ac160002"
                }
            },
            # Construct a GUID for the AAS ELA21.AAS.K Standard node.
            # This is a mid-level non-leaf node, so it has both Document and Item IDs.
            {
                "caseGuid": {
                    "caseDocumentId": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
                    "caseItemId": "ada2cc30-7d6d-494e-8c6b-c998bae98f0b",
                }
            },
        ]
    }
}

course = (
    service.courses()
    .patch(
      id=course_id,
      updateMask="learningStandardSettings",
      body=course,
      # Specify the preview version while the feature is in Developer Preview.
      # Learning standards and goals are supported in V1_20260316_PREVIEW and
      # later.
      previewVersion="V1_20260316_PREVIEW")
    .execute()
)
print(f"Course updated: {course.get('name')}")

Recuperar conjuntos de padrões de aprendizado

Para conferir os conjuntos de padrões de aprendizado atuais de um curso, inspecione o campo Course.learningStandardSettings. Esse campo contém uma série de objetos standardSets e pode estar vazio se nenhum conjunto de padrões de aprendizado estiver presente no curso.

Cada standardSet na resposta contém a descrição do padrão e o título do documento raiz. Esses textos também aparecem para professores e estudantes na interface do Google Sala de Aula. Você também recebe o sourceDataAvailabilityStatus, que indica se o padrão está disponível no Satchel Rosetta Exchange.

{
  "id": "123456789",
  "name": "LSS test class",
  "learningStandardSettings": {
    "standardSets": [
      {
        "caseGuid": {
          "caseDocumentId": "c649d172-d7cb-11e8-824f-0242ac160002"
        },
        "documentTitle": "New York State Next Generation Mathematics Learning Standards",
        "sourceDataAvailabilityStatus": "LEARNING_STANDARD_AVAILABLE"
      },
      {
        "caseGuid": {
          "caseDocumentId": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
          "caseItemId": "ada2cc30-7d6d-494e-8c6b-c998bae98f0b"
        },
        "documentTitle": "AAS English Language Arts (2021)",
        "standardTitle": "Kindergarten",
        "sourceDataAvailabilityStatus": "LEARNING_STANDARD_AVAILABLE"
      }
    ]
  }
}

Gerenciar metas de aprendizado de atividades, materiais e rubricas

Modificar metas de aprendizado

As metas de aprendizado podem ser anexadas a recursos CourseWork, CourseWorkMaterial e Criterion de rubrica em qualquer solicitação de mutação. Defina os identificadores de documentos e itens nos campos CourseWork.learningGoals ou Rubric.Criterion.learningGoal. Esses são os mesmos identificadores descritos anteriormente.

As metas de aprendizado anexadas aos critérios de Rubric já precisam ter sido anexadas à atividade a que a Rubric está vinculada.

O exemplo a seguir cria uma atividade CourseWork com duas metas de aprendizado anexadas.

Python

# Create a CourseWork assignment with two attached learning goals.
service = build("classroom", "v1", credentials=creds)
coursework = {
    "title": "Ant colonies",
    "description": "Read the article about ant colonies and complete the quiz.",
    "materials": [
        {"link": {"url": "http://example.com/ant-colonies"}},
        {"link": {"url": "http://example.com/ant-quiz"}},
    ],
    "workType": "ASSIGNMENT",
    "state": "PUBLISHED",
    # Each CourseWork can have up to 10 learning goals.
    "learningGoals": [
        {
            "learningStandardInfo": {
                # Construct a GUID for the ELA21.AAS.11.11c Standard node.
                # This is a non-root node, so it has both Document and Item IDs.
                "caseGuid": {
                    "caseDocumentId": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
                    "caseItemId": "6d922f1f-b580-42a1-b6d2-5ee5b39c561d",
                }
            }
        },
        {
            "learningStandardInfo": {
                # Construct a GUID for the ELA21.AAS.11.22a Standard node.
                # This is a non-root node, so it has both Document and Item IDs.
                "caseGuid": {
                    "caseDocumentId": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
                    "caseItemId": "a684609a-c3ec-42da-8b7f-7a325b31ea4a",
                }
            }
        },
    ],
}

coursework = (
    service.courses()
    .courseWork()
    .create(
      courseId=course_id,
      body=coursework,
      # Specify the preview version while the feature is in Developer Preview.
      # Learning standards and goals are supported in V1_20260316_PREVIEW and
      # later.
      previewVersion="V1_20260316_PREVIEW")
    .execute()
)
print(f"Assignment created with ID {coursework.get('id')}")

O exemplo a seguir cria uma Rubric com um objetivo de aprendizado anexado a cada critério.

Python

# Create a new Rubric with a learning goal attached to each criterion.
service = build("classroom", "v1", credentials=creds)
body = {
    "criteria": [
        {
            "title": "Argument",
            "description": "How well structured your argument is.",
            "levels": [
                {
                    "title": "Convincing",
                    "description": "A compelling case is made.",
                    "points": 30,
                },
                {
                    "title": "Passable",
                    "description": "Missing some evidence.",
                    "points": 20,
                },
                {
                    "title": "Needs Work",
                    "description": "Not enough strong evidence.",
                    "points": 0,
                },
            ],
            # Each Criterion can have one learning goal.
            "learningGoal": {
                "learningStandardInfo": {
                    # Construct a GUID for the ELA21.AAS.11.11c Standard node.
                    # This is a non-root node, so it has both Document and Item IDs.
                    "caseGuid": {
                        "caseDocumentId": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
                        "caseItemId": "6d922f1f-b580-42a1-b6d2-5ee5b39c561d",
                    }
                }
            },
        },
        {
            "title": "Spelling",
            "description": "How well you spelled all the words.",
            "levels": [
                {"title": "Perfect", "description": "No mistakes.", "points": 20},
                {"title": "Great", "description": "A mistake or two.", "points": 15},
                {"title": "Needs Work", "description": "Many mistakes.", "points": 5},
            ],
            # Each Criterion can have one learning goal.
            "learningGoal": {
                "learningStandardInfo": {
                    # Construct a GUID for the ELA21.AAS.11.22a Standard node.
                    # This is a non-root node, so it has both Document and Item IDs.
                    "caseGuid": {
                        "caseDocumentId": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
                        "caseItemId": "a684609a-c3ec-42da-8b7f-7a325b31ea4a",
                    }
                }
            },
        },
    ]
}

rubric = (
    service.courses()
    .courseWork()
    .rubrics()
    .create(
      courseId=course_id,
      courseWorkId=coursework_id,
      body=body,
      # Specify the preview version while the feature is in Developer Preview.
      # Learning standards and goals are supported in V1_20260316_PREVIEW and
      # later.
      previewVersion="V1_20260316_PREVIEW")
    .execute()
)
print(f"Rubric created with ID {rubric.get('id')}")

Recuperar metas de aprendizado

Para conferir as metas de aprendizado atuais em uma atividade, pergunta ou material, inspecione o campo CourseWork.learningGoals. Cada objeto de meta de aprendizado contém o título do documento de nível raiz e o código padrão de aprendizado.

Os professores também podem adicionar tags de habilidades a atividades e materiais na interface do Google Sala de Aula. As tags de habilidades não estão acessíveis na API.

{
  "course_id": "123456789",
  "id": "987654321",
  "title": "Test ELA Assignment",
  "state": "PUBLISHED",
  "learningGoals": [
    {
      "id": "871768554412",
      "courseId": "123456789",
      "learningStandardInfo": {
        "standardCode": "ELA21.AAS.11.22a",
        "caseGuid": {
          "caseDocumentId": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
          "caseItemId": "a684609a-c3ec-42da-8b7f-7a325b31ea4a"
        }
      },
      "title": "Identify a sentence that uses correct capitalization (i.e., beginning of sentence, names, cities, states, countries, towns, titles, days, months)."
    },
    {
      "id": "871768554411",
      "courseId": "123456789",
      "learningStandardInfo": {
        "standardCode": "ELA21.AAS.11.11c",
        "caseGuid": {
          "caseDocumentId": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
          "caseItemId": "6d922f1f-b580-42a1-b6d2-5ee5b39c561d"
        }
      },
      "title": "Compose argumentative texts by stating a topic, providing reasons that support the argument, and providing an appropriate conclusion related to the topic."
    }
  ]
}

Dados semelhantes são retornados com respostas Rubric, contendo um learningGoal por critério.