Strumento: create_topic
Crea un nuovo argomento in un corso. Gli argomenti vengono utilizzati per organizzare le attività del corso. Richiede un ruolo di insegnante nel corso.
Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP create_topic.
| 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": "create_topic", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
Schema di input
Richiesta di creazione di un argomento in un corso.
CreateTopicRequest
| Rappresentazione JSON |
|---|
{ "courseId": string, "title": string } |
| Campi | |
|---|---|
courseId |
Obbligatorio. Identificatore del corso. |
title |
Obbligatorio. Titolo dell'argomento. Deve contenere massimo 100 caratteri. |
Schema di output
Un argomento di un corso.
Argomento
| Rappresentazione JSON |
|---|
{ "id": string, "title": string } |
| Campi | |
|---|---|
id |
Solo output. Identificatore. ID argomento. |
title |
Titolo dell'argomento. |
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.
Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/classroom.topics