Tool: list_courses
Listet die Kurse des Nutzers mit den entsprechenden Details auf (Abschnitt, Raum, Fach, Kurs-/Klassenstufen, Beschreibung, Lernziele, Status und Rolle des Nutzers). Verwenden Sie dies als primären Einstiegspunkt, um Kurse zu finden und ihre IDs abzurufen. Kurse haben oft denselben Titel. Verwenden Sie daher den Abschnitt, um sie voneinander zu unterscheiden. Gibt nur AKTIVE Kurse zurück, es sei denn, „courseState“ ist festgelegt (z.B. ARCHIVIERT).
Wenn Sie den Nutzer mit einem Kurs in der Classroom-Web-App verknüpfen möchten, verwenden Sie https://classroom.google.com/c/{course_id} (Stream) oder https://classroom.google.com/w/{course_id}/t/all (Seite „Kursaufgaben“). Verwenden Sie IDs genau so, wie sie zurückgegeben werden. Erraten oder ändern Sie sie nicht.
Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool list_courses aufrufen.
| Curl-Anfrage |
|---|
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": "list_courses", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
Eingabeschema
Anfrage zum Auflisten von Kursen.
ListCoursesRequest
| JSON-Darstellung |
|---|
{ "courseState": enum ( |
| Felder | |
|---|---|
courseState |
Optional. Nach Kursstatus filtern. Die Standardeinstellung ist |
createdDateRange |
Optional. Nach Erstellungsdatum filtern. |
timeZone |
Erforderlich. Die IANA-Zeitzone des Nutzers (z.B. |
titleContains |
Optional. Filtert den Titel nach einem Teilstring, wobei die Groß-/Kleinschreibung ignoriert wird. |
pageSize |
Optional. Steuert die Seitengröße. Der Standardwert ist 10, der Höchstwert 50. |
pageToken |
Optional. Token für die Paginierung. |
DateRange
| JSON-Darstellung |
|---|
{ "startDate": string, "endDate": string } |
| Felder | |
|---|---|
startDate |
Inklusiver Beginn des Bereichs (Format: JJJJ-MM-TT). |
endDate |
Inklusives Ende des Bereichs (Format: JJJJ-MM-TT). |
Bundesland
Status eines Kurses.
| Enums | |
|---|---|
STATE_UNSPECIFIED |
Nicht angegebener Zustand. |
ACTIVE |
Aktiver Status. |
ARCHIVED |
Archivierter Status. |
PROVISIONED |
Bereitgestellter Status. |
Ausgabeschema
Antwort auf die Anfrage zum Auflisten von Kursen.
ListCoursesResponse
| JSON-Darstellung |
|---|
{
"courses": [
{
object ( |
| Felder | |
|---|---|
courses[] |
Die Liste der Kurse. |
nextPageToken |
Das Token für die nächste Seite. |
Kurs
| JSON-Darstellung |
|---|
{ "id": string, "title": string, "role": enum ( |
| Felder | |
|---|---|
id |
ID. Kennung für diesen Kurs. |
title |
Titel des Kurses. |
role |
Rolle des Nutzers in diesem Kurs. |
creationDate |
Erstellungsdatum des Kurses (Format: JJJJ-MM-TT). Leer, wenn das Erstellungsdatum nicht bekannt ist. |
state |
Nur Ausgabe. Status des Kurses. |
section |
Optional. Abschnitt des Kurses. |
room |
Optional. Raum des Kurses. |
subject |
Optional. Thema des Kurses. |
gradeLevels |
Optional. Klassenstufen des Kurses. |
description |
Optional. Beschreibung des Kurses. |
learningGoals[] |
Nur Ausgabe. Lernziele, die mit diesem Kurs verknüpft sind. |
LearningGoal
| JSON-Darstellung |
|---|
{
"id": string,
"type": enum ( |
| Felder | |
|---|---|
id |
Nur Ausgabe. ID des Lernziels. Wenn Sie einen Standard anhängen möchten, verwenden Sie eine |
type |
Nur Ausgabe. Der Typ des Lernziels. |
standardCode |
Nur Ausgabe. Standardcode (z.B. „NY-2.NBT.4“). Wird nur für Standards ausgefüllt. |
title |
Nur Ausgabe. Beschreibung der Anforderung für Standards oder menschenlesbarer Titel für Fähigkeiten. |
documentTitle |
Nur Ausgabe. Name des Lehrplandokuments. Wird nur für Standards ausgefüllt. |
Rolle
Rollen eines Nutzers in einem Kurs.
| Enums | |
|---|---|
ROLE_UNSPECIFIED |
Nicht angegebene Rolle. |
TEACHER |
Lehrkraft. |
COTEACHER |
Rolle „Zusätzliche Lehrkraft“. |
STUDENT |
Schüler/Student. |
INVITED_OR_INACTIVE |
Eingeladene oder inaktive Rolle. |
Bundesland
Status eines Kurses.
| Enums | |
|---|---|
STATE_UNSPECIFIED |
Nicht angegebener Zustand. |
ACTIVE |
Aktiver Status. |
ARCHIVED |
Archivierter Status. |
PROVISIONED |
Bereitgestellter Status. |
Typ
Der Typ des Lernziels.
| Enums | |
|---|---|
TYPE_UNSPECIFIED |
Nicht angegebener Lernzieltyp. |
STANDARD |
Ein Bildungsstandard aus einem akademischen Lehrplan. |
SKILL |
Eine Fähigkeit, die ein pädagogisches Konzept oder eine Kompetenz darstellt. Nur Lehrkräfte können in Classroom Kompetenzen hinzufügen oder entfernen. |
Tool-Annotationen
Tool-Anmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können jedoch verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet werden soll.
Zusätzlich zum Titelstring werden die folgenden booleschen Hinweise definiert:
readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: false.destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: true.idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: false.openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Entitäten interagieren. Wenn „false“, kann das Tool nur mit internen Entitäten interagieren. Ein Tool für die Websuche wäre beispielsweise frei verfügbar, ein Tool für gemerkte Informationen jedoch nicht.
Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Hinweis „Lesezugriff“: ✅ | Hinweis „Open World“: ❌
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/classroom.courses.readonlyhttps://www.googleapis.com/auth/classroom.rosters.readonly