Outil : search_course_standards
Recherche des normes d'apprentissage académiques dans un cours pour les ajouter à des documents de travail ou à des grilles d'évaluation. Le cours doit avoir des normes d'apprentissage configurées par l'enseignant.
- Normes spécifiques : recherchez un code exact (par exemple, "HS-LS1-1") ou des mots clés spécifiques (includeGroupingStandards=false).
- Catégories : définissez includeGroupingStandards=true avec un mot-clé général pour trouver les catégories parentes, puis transmettez l'ID de catégorie dans learningStandardIds pour affiner les résultats.
L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP search_course_standards.
| Requête curl |
|---|
curl --location 'https://classroommcp.googleapis.com/mcp/v1' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "search_course_standards", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
Schéma d'entrée
Demande de recherche dans les arbres de normes d'apprentissage présélectionnés au niveau du cours.
SearchCourseStandardsRequest
| Représentation JSON |
|---|
{ "courseId": string, "learningStandardIds": [ string ], "query": string, "includeGroupingStandards": boolean } |
| Champs | |
|---|---|
courseId |
Obligatoire. Identifiant du cours. |
learningStandardIds[] |
Facultatif. Limite la recherche à ces référentiels ou normes de catégorie et à leurs descendants. Transmettez un ID de référentiel de |
query |
Obligatoire. Termes de recherche non sensibles à la casse. Les résultats doivent contenir TOUS les mots séparés par des espaces dans leur code ou leur instruction. - Lorsque |
includeGroupingStandards |
Facultatif. Si la valeur est "true", renvoie les en-têtes de catégorie (qui ne peuvent pas être tagués dans les documents de travail) dont les ID affinent les recherches ultérieures. Si la valeur est "false" (par défaut), renvoie les normes pouvant être taguées sur les documents de travail. |
Schéma de sortie
Réponse contenant des normes d'apprentissage.
SearchCourseStandardsResponse
| Représentation JSON |
|---|
{
"learningStandards": [
{
object ( |
| Champs | |
|---|---|
learningStandards[] |
Liste des normes correspondantes. |
LearningGoal
| Représentation JSON |
|---|
{
"id": string,
"type": enum ( |
| Champs | |
|---|---|
id |
Uniquement en sortie. ID de l'objectif d'apprentissage. Pour associer un standard, utilisez un |
type |
Uniquement en sortie. Type d'objectif d'apprentissage. |
standardCode |
Uniquement en sortie. Code standard (par exemple, "NY-2.NBT.4"). Renseigné uniquement pour les normes. |
title |
Uniquement en sortie. Description de l'instruction pour les normes ou titre lisible par l'humain pour les compétences. |
documentTitle |
Uniquement en sortie. Nom du document du programme. Renseigné uniquement pour les normes. |
Type
Type d'objectif d'apprentissage.
| Enums | |
|---|---|
TYPE_UNSPECIFIED |
Type d'objectif d'apprentissage non spécifié. |
STANDARD |
Norme d'apprentissage d'un programme scolaire. |
SKILL |
Compétence représentant un concept ou une compétence pédagogique. Seul un enseignant peut ajouter ou supprimer des compétences dans Classroom. |
Annotations d'outils
Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients considèrent ces indications comme non fiables, mais elles peuvent être utilisées pour décider quand envoyer une invite de confirmation à un utilisateur.
En plus de la chaîne de titre, les indications booléennes suivantes sont définies comme suit :
readOnlyHint: si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".destructiveHint: si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions d'ajout. Valeur par défaut : "true".idempotentHint: si la valeur est "true", l'appel répété de l'outil avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".openWorldHint: si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche sur le Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.
Indication de destruction : ❌ | Indication d'idempotence : ✅ | Indication de lecture seule : ✅ | Indication en monde ouvert : ❌
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/classroom.courseshttps://www.googleapis.com/auth/classroom.courses.readonly