Os usuários podem definir metas de aprendizado para cursos e atividades no Google Sala de Aula.
Os mesmos objetivos de aprendizado também são expostos na API Classroom. É possível
definir, recuperar e modificar conjuntos de padrões de aprendizado nos recursos do Course
e objetivos de aprendizado nos recursos do CourseWork e
Rubric. Este guia descreve como acessar e modificar metas de aprendizado e conjuntos padrão usando a API Classroom.
Como funciona
Fonte de dados
As metas de aprendizado no Google Sala de Aula dependem de identificadores exclusivos globais (GUIDs) estáveis fornecidos pela Satchel Rosetta Exchange (antiga CASE Network). Os padrões na 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 padrão de aprendizado em um Course.
- Os conjuntos de padrões de aprendizado para um recurso
Courserepresentam 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 recurso
CourseWork,CourseWorkMaterialouRubricrepresentam o padrão ou as habilidades associadas a essa atividade, pergunta, material ou critério específico da rubrica.
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:
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 ver os valores de um padrão específico, clique nele e expanda os metadados:
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 documento e item 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
Coursepode ter até cinco conjuntos de padrões de aprendizado. - Cada
CourseWorkpode ter até 10 metas de aprendizado. - Cada rubrica
Criterionpode ter uma meta de aprendizado.
Gerenciar conjuntos de padrões de aprendizado do curso
Modificar repositórios curriculares
Para modificar os conjuntos padrão 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 solicitação de mutação Course, como
courses.create() ou courses.patch() com
a máscara de atualização learningStandardSettings.
O exemplo a seguir define dois conjuntos padrão em um curso existente.
Python
service = build("classroom", "v1", credentials=creds)
course = {
"learning_standard_settings": {
# Each Course can have up to 5 learning standard sets.
"standard_sets": [
# 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.
{
"case_guid": {
"case_document_id": "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.
{
"case_guid": {
"case_document_id": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
"case_item_id": "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 não houver conjuntos de padrões de aprendizado 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 na Satchel Rosetta Exchange.
{
"id": "123456789",
"name": "LSS test class",
"learning_standard_settings": {
"standard_sets": [{
"case_guid": {
"case_document_id": "c649d172-d7cb-11e8-824f-0242ac160002"
},
"document_title": "New York State Next Generation Mathematics Learning Standards",
"source_data_availability_status": "LEARNING_STANDARD_AVAILABLE"
},
{
"case_guid": {
"case_document_id": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
"case_item_id": "d52217c0-1c5b-4d92-9664-d0792944f3fe"
},
"document_title": "AAS English Language Arts (2021)",
"standard_title": "With prompting and support, actively listen and speak.",
"source_data_availability_status": "LEARNING_STANDARD_AVAILABLE"
}]
}
}
Gerenciar metas de aprendizado de tarefas e rubricas
Modificar metas de aprendizado
As metas de aprendizado podem ser anexadas aos recursos CourseWork, CourseWorkMaterial e Rubric Criterion em qualquer solicitação de mutação. Defina os identificadores de documento e item nos campos CourseWork.learningGoals ou Rubric.Criterion.learningGoal. São os mesmos identificadores descritos anteriormente.
As metas de aprendizado vinculadas aos critérios de Rubric precisam ter sido vinculadas à atividade a que o Rubric está associado.
O exemplo a seguir cria uma atribuição 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.
"learning_goals": [
{
"learning_standard_info": {
# 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.
"case_guid": {
"case_document_id": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
"case_item_id": "6d922f1f-b580-42a1-b6d2-5ee5b39c561d",
}
}
},
{
"learning_standard_info": {
# 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.
"case_guid": {
"case_document_id": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
"case_item_id": "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 um Rubric com uma meta de aprendizado anexada 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.
"learning_goal": {
"learning_standard_info": {
# 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.
"case_guid": {
"case_document_id": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
"case_item_id": "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.
"learning_goal": {
"learning_standard_info": {
# 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.
"case_guid": {
"case_document_id": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
"case_item_id": "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 no nível raiz e o código do padrão de aprendizado.
Os professores também podem adicionar tags de habilidade a atividades e materiais na interface do Google Sala de Aula. As tags de habilidade não estão acessíveis na API.
{
"course_id": "123456789",
"id": "987654321",
"title": "Test ELA Assignment",
"state": "PUBLISHED",
"learning_goals": [
{
"learning_standard_info": {
"standard_code": "ELA21.AAS.11.11c",
"document_title": "AAS English Language Arts (2021)",
"case_guid": {
"case_document_id": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
"case_item_id": "6d922f1f-b580-42a1-b6d2-5ee5b39c561d",
},
"source_data_availability_status": "LEARNING_STANDARD_AVAILABLE"
},
"title": "Compose argumentative texts by stating a topic, providing reasons that support the argument, and providing an appropriate conclusion related to the topic."
},
{
"learning_standard_info": {
"standard_code": "ELA21.AAS.11.22a",
"document_title": "AAS English Language Arts (2021)",
"case_guid": {
"case_document_id": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
"case_item_id": "a684609a-c3ec-42da-8b7f-7a325b31ea4a",
},
"source_data_availability_status": "LEARNING_STANDARD_AVAILABLE"
},
"title": "Identify a sentence that uses correct capitalization (i.e., beginning of sentence, names, cities, states, countries, towns, titles, days, months)."
}]
}
Dados semelhantes são retornados com respostas Rubric, contendo um learningGoal
por critério.