Ferramenta: create_topic
Cria um novo tópico em um curso. Os tópicos são usados para organizar as atividades. Exige uma função de professor no curso.
O exemplo de código a seguir mostra como usar curl para chamar a ferramenta MCP create_topic.
| Solicitação 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 }' |
Esquema de entrada
Solicitação para criar um tópico em um curso.
CreateTopicRequest
| Representação JSON |
|---|
{ "courseId": string, "title": string } |
| Campos | |
|---|---|
courseId |
Obrigatório. Identificador do curso. |
title |
Obrigatório. Título do tópico. Precisa ter no máximo 100 caracteres. |
Esquema de saída
Um tópico em um curso.
Tópico
| Representação JSON |
|---|
{ "id": string, "title": string } |
| Campos | |
|---|---|
id |
Apenas saída. Identificador. ID do tópico. |
title |
Título do tópico. |
Anotações de ferramentas
As anotações de ferramentas são enviadas aos clientes do MCP para descrever o risco básico de uma determinada ferramenta. A maioria dos clientes trata essas dicas como não confiáveis, mas elas podem ser usadas para decidir quando um pedido de confirmação pode ser enviado a um usuário.
Além da string de título, as seguintes dicas booleanas são definidas:
readOnlyHint: se for verdadeiro, a ferramenta não vai modificar o ambiente. (Padrão: falso).destructiveHint: se for verdadeiro, a ferramenta poderá realizar ações destrutivas. Se for falso, a ferramenta só poderá realizar ações aditivas. Padrão: verdadeiro.idempotentHint: se for verdadeiro, chamar a ferramenta repetidamente com os mesmos argumentos não terá efeito adicional no ambiente. (Padrão: falso).openWorldHint: se for verdadeiro, a ferramenta poderá interagir com um "mundo aberto" de entidades externas. Se for falso, a ferramenta só poderá interagir com entidades internas. Por exemplo, uma ferramenta de pesquisa na Web seria de mundo aberto, enquanto uma ferramenta de memória não seria.
Dica destrutiva: ❌ | Dica idempotente: ❌ | Dica somente leitura: ❌ | Dica de mundo aberto: ❌
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/classroom.topics