Narzędzie: list_courses
Wyświetla listę zajęć użytkownika wraz ze szczegółowymi informacjami (sekcja, sala, przedmiot, poziomy nauczania, opis, cele edukacyjne, stan i rola użytkownika). Używaj tego jako głównego punktu wejścia do odkrywania kursów i pobierania ich identyfikatorów. Zajęcia często mają ten sam tytuł, więc użyj sekcji, aby je odróżnić. Zwraca tylko AKTYWNE zajęcia, chyba że ustawiono parametr courseState (np. ARCHIVED).
Aby przekierować użytkownika do zajęć w aplikacji internetowej Classroom, użyj adresu https://classroom.google.com/c/{course_id} (strumień) lub https://classroom.google.com/w/{course_id}/t/all (strona Zadania). Używaj identyfikatorów dokładnie w takiej postaci, w jakiej zostały zwrócone. Nigdy ich nie zgaduj ani nie modyfikuj.
Poniższy przykładowy kod pokazuje, jak używać curl do wywoływania narzędzia MCP list_courses.
| Żądanie 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": "list_courses", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
Schemat wejściowy
Żądanie wyświetlenia listy zajęć.
ListCoursesRequest
| Zapis JSON |
|---|
{ "courseState": enum ( |
| Pola | |
|---|---|
courseState |
Opcjonalnie: Filtruj według stanu zajęć. Domyślna wartość to |
createdDateRange |
Opcjonalnie: Filtruj według zakresu dat utworzenia. |
timeZone |
Wymagane. Strefa czasowa IANA użytkownika (np. |
titleContains |
Opcjonalnie: Filtruj tytuł według podłańcucha, wielkość liter nie jest rozróżniana. |
pageSize |
Opcjonalnie: Określa rozmiar strony. Domyślna wartość to 10, a maksymalna – 50. |
pageToken |
Opcjonalnie: Token podziału na strony. |
Zakres dat
| Zapis JSON |
|---|
{ "startDate": string, "endDate": string } |
| Pola | |
|---|---|
startDate |
Początek zakresu (włącznie, format: RRRR-MM-DD). |
endDate |
Koniec zakresu (format: RRRR-MM-DD). |
Stan
Stany kursu.
| Wartości w polu enum | |
|---|---|
STATE_UNSPECIFIED |
Stan nieokreślony. |
ACTIVE |
Stan aktywny. |
ARCHIVED |
Stan zarchiwizowania. |
PROVISIONED |
Stan obsługi administracyjnej. |
Schemat wyjściowy
Odpowiedź na prośbę o wyświetlenie listy zajęć.
ListCoursesResponse
| Zapis JSON |
|---|
{
"courses": [
{
object ( |
| Pola | |
|---|---|
courses[] |
Lista kursów. |
nextPageToken |
Token następnej strony. |
Kurs
| Zapis JSON |
|---|
{ "id": string, "title": string, "role": enum ( |
| Pola | |
|---|---|
id |
Identyfikator. Identyfikator tych zajęć. |
title |
Tytuł kursu. |
role |
Rola użytkownika na tych zajęciach. |
creationDate |
Data utworzenia kursu (format: RRRR-MM-DD). Jeśli data utworzenia jest nieznana, pole jest puste. |
state |
Tylko dane wyjściowe. Stan kursu. |
section |
Opcjonalnie: Sekcja kursu. |
room |
Opcjonalnie: Sala, w której odbywają się zajęcia. |
subject |
Opcjonalnie: Temat kursu. |
gradeLevels |
Opcjonalnie: Poziomy nauczania kursu. |
description |
Opcjonalnie: Opis kursu. |
learningGoals[] |
Tylko dane wyjściowe. Cele edukacyjne dołączone do tego kursu. |
LearningGoal
| Zapis JSON |
|---|
{
"id": string,
"type": enum ( |
| Pola | |
|---|---|
id |
Tylko dane wyjściowe. Identyfikator celu edukacyjnego. Aby dołączyć standard, użyj |
type |
Tylko dane wyjściowe. Typ celu edukacyjnego. |
standardCode |
Tylko dane wyjściowe. Kod standardu (np. „NY-2.NBT.4”). Wartość jest podawana tylko w przypadku standardów. |
title |
Tylko dane wyjściowe. Opis oświadczenia dotyczącego standardów lub zrozumiały dla człowieka tytuł dotyczący umiejętności. |
documentTitle |
Tylko dane wyjściowe. Nazwa dokumentu programu nauczania. Wartość jest podawana tylko w przypadku standardów. |
Rola
Role użytkownika na zajęciach.
| Wartości w polu enum | |
|---|---|
ROLE_UNSPECIFIED |
Nieokreślona rola. |
TEACHER |
Rola nauczyciela. |
COTEACHER |
Rola nauczyciela współprowadzącego. |
STUDENT |
Rola ucznia. |
INVITED_OR_INACTIVE |
Zaproszona lub nieaktywna rola. |
Stan
Stany kursu.
| Wartości w polu enum | |
|---|---|
STATE_UNSPECIFIED |
Stan nieokreślony. |
ACTIVE |
Stan aktywny. |
ARCHIVED |
Stan zarchiwizowania. |
PROVISIONED |
Stan obsługi administracyjnej. |
Typ
Typ celu edukacyjnego.
| Wartości w polu enum | |
|---|---|
TYPE_UNSPECIFIED |
Nieokreślony typ celu edukacyjnego. |
STANDARD |
Standard nauczania z programu akademickiego. |
SKILL |
Umiejętność reprezentująca koncepcję lub kompetencję edukacyjną. Tylko nauczyciel może dodawać i usuwać umiejętności w Classroom. |
Adnotacje dotyczące narzędzi
Adnotacje narzędzia są wysyłane do klientów MCP, aby opisać podstawowe ryzyko związane z danym narzędziem. Większość klientów traktuje te wskazówki jako niezaufane, ale można ich użyć do określenia, kiedy wysłać użytkownikowi prośbę o potwierdzenie.
Oprócz ciągu tytułu zdefiniowane są te wskazówki logiczne:
readOnlyHint: jeśli ma wartość „true”, narzędzie nie modyfikuje swojego środowiska. Wartość domyślna: false.destructiveHint: jeśli ma wartość „true”, narzędzie może wykonywać działania destrukcyjne. Jeśli ma wartość false, narzędzie może wykonywać tylko działania dodawania. Wartość domyślna: true.idempotentHint: jeśli ma wartość „true”, wielokrotne wywoływanie narzędzia z tymi samymi argumentami nie będzie miało dodatkowego wpływu na jego środowisko. Wartość domyślna: false.openWorldHint: jeśli ma wartość true, narzędzie może wchodzić w interakcje z „otwartym światem” podmiotów zewnętrznych. Jeśli ma wartość false, narzędzie może wchodzić w interakcje tylko z elementami wewnętrznymi. Na przykład narzędzie do wyszukiwania w internecie jest narzędziem typu Otwarty świat, a narzędzie do zapamiętywania – nie.
Wskazówka dotycząca destrukcyjności: ❌ | Wskazówka dotycząca idempotencji: ✅ | Wskazówka dotycząca tylko do odczytu: ✅ | Wskazówka dotycząca otwartego świata: ❌
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/classroom.courses.readonlyhttps://www.googleapis.com/auth/classroom.rosters.readonly