Strumento: search_course_standards
Cerca gli standard di apprendimento accademico in un corso per taggare i materiali del corso o le griglie. Richiede che il corso abbia standard di apprendimento configurati dall'insegnante.
- Standard specifici: cerca con il codice esatto (ad es. "HS-LS1-1") o con parole chiave specifiche (includeGroupingStandards=false).
- Categorie: imposta includeGroupingStandards=true con una parola chiave generica per trovare le categorie principali, quindi passa l'ID categoria in learningStandardIds per restringere i risultati.
Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP search_course_standards.
| Richiesta 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 }' |
Schema di input
Richiesta di ricerca negli alberi degli standard di apprendimento a livello di corso preselezionati.
SearchCourseStandardsRequest
| Rappresentazione JSON |
|---|
{ "courseId": string, "learningStandardIds": [ string ], "query": string, "includeGroupingStandards": boolean } |
| Campi | |
|---|---|
courseId |
Obbligatorio. Identificatore del corso. |
learningStandardIds[] |
Facoltativo. Limita la ricerca a questi set di standard o standard di categoria e ai relativi discendenti. Passa un ID set di standard da |
query |
Obbligatorio. Termini di ricerca senza distinzione tra maiuscole e minuscole; i risultati devono contenere TUTTE le parole separate da spazi nel codice o nell'istruzione. - Quando |
includeGroupingStandards |
Facoltativo. Se true, restituisce le intestazioni delle categorie (non taggabili per i materiali del corso) i cui ID restringono le ricerche successive. Se è false (valore predefinito), restituisce gli standard che possono essere taggati nei materiali del corso. |
Schema di output
Risposta contenente gli standard di apprendimento.
SearchCourseStandardsResponse
| Rappresentazione JSON |
|---|
{
"learningStandards": [
{
object ( |
| Campi | |
|---|---|
learningStandards[] |
L'elenco degli standard corrispondenti. |
LearningGoal
| Rappresentazione JSON |
|---|
{
"id": string,
"type": enum ( |
| Campi | |
|---|---|
id |
Solo output. ID dell'obiettivo di apprendimento. Per allegare uno standard, utilizza un |
type |
Solo output. Il tipo di obiettivo di apprendimento. |
standardCode |
Solo output. Codice standard (ad es. "NY-2.NBT.4"). Compilato solo per gli standard. |
title |
Solo output. Descrizione dell'istruzione per gli standard o titolo leggibile per le competenze. |
documentTitle |
Solo output. Nome del documento del programma. Compilato solo per gli standard. |
Tipo
Il tipo di obiettivo di apprendimento.
| Enum | |
|---|---|
TYPE_UNSPECIFIED |
Tipo di obiettivo di apprendimento non specificato. |
STANDARD |
Uno standard di apprendimento di un programma accademico. |
SKILL |
Una competenza che rappresenta un concetto o una competenza didattica. Solo un insegnante può aggiungere o rimuovere competenze in Classroom. |
Annotazioni dello strumento
Le annotazioni degli strumenti vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client considera questi suggerimenti come non attendibili, ma possono essere utilizzati per decidere quando inviare una richiesta di conferma a un utente.
Oltre alla stringa del titolo, i seguenti suggerimenti booleani sono definiti come segue:
readOnlyHint: se true, lo strumento non modifica il suo ambiente. Valore predefinito: false.destructiveHint: se true, lo strumento può eseguire azioni distruttive. Se false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.idempotentHint: se true, la chiamata ripetuta dello strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.openWorldHint: se true, lo strumento può interagire con un "open world" di entità esterne. Se è impostato su false, lo strumento può interagire solo con entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria non lo sarebbe.
Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/classroom.courseshttps://www.googleapis.com/auth/classroom.courses.readonly