도구: list_courses
사용자의 수업을 세부정보(섹션, 교실, 과목, 학년, 설명, 학습 목표, 상태, 사용자의 역할)와 함께 나열합니다. 이 메서드를 기본 진입점으로 사용하여 강의를 검색하고 ID를 가져옵니다. 강의는 제목을 공유하는 경우가 많으므로 섹션을 사용하여 구분하세요. courseState가 설정되지 않은 경우(예: ARCHIVED) ACTIVE 과정만 반환합니다.
사용자를 클래스룸 웹 앱의 수업에 연결하려면 https://classroom.google.com/c/{course_id}(스트림) 또는 https://classroom.google.com/w/{course_id}/t/all(수업 과제 페이지)을 사용합니다. 반환된 ID를 그대로 사용하고 추측하거나 수정하지 마세요.
다음 코드 샘플은 curl를 사용하여 list_courses MCP 도구를 호출하는 방법을 보여줍니다.
| 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 }' |
입력 스키마
강의를 나열하는 요청입니다.
ListCoursesRequest
| JSON 표현 |
|---|
{ "courseState": enum ( |
| 필드 | |
|---|---|
courseState |
선택사항입니다. 강의 상태로 필터링합니다. 기본값은 |
createdDateRange |
선택사항입니다. 생성일 범위로 필터링합니다. |
timeZone |
필수 항목입니다. 사용자의 IANA 시간대(예: |
titleContains |
선택사항입니다. 대소문자를 구분하지 않는 하위 문자열로 제목을 필터링합니다. |
pageSize |
선택사항입니다. 페이지 크기를 제어합니다. 기본값은 10이며 최댓값은 50입니다. |
pageToken |
선택사항입니다. 페이지로 나누기 토큰입니다. |
DateRange
| JSON 표현 |
|---|
{ "startDate": string, "endDate": string } |
| 필드 | |
|---|---|
startDate |
범위의 시작일(포함)(형식: YYYY-MM-DD)입니다. |
endDate |
범위의 종료일(포함)(형식: YYYY-MM-DD)입니다. |
주
과정의 상태입니다.
| 열거형 | |
|---|---|
STATE_UNSPECIFIED |
지정되지 않은 상태입니다. |
ACTIVE |
활성 상태입니다. |
ARCHIVED |
보관처리된 상태입니다. |
PROVISIONED |
프로비저닝된 상태입니다. |
출력 스키마
과정을 나열하는 응답입니다.
ListCoursesResponse
| JSON 표현 |
|---|
{
"courses": [
{
object ( |
| 필드 | |
|---|---|
courses[] |
과정 목록입니다. |
nextPageToken |
다음 페이지 토큰입니다. |
과정
| JSON 표현 |
|---|
{ "id": string, "title": string, "role": enum ( |
| 필드 | |
|---|---|
id |
식별자. 이 수업의 식별자입니다. |
title |
과정 제목입니다. |
role |
이 과정에서 사용자의 역할입니다. |
creationDate |
과정 생성일입니다(형식: YYYY-MM-DD). 생성 날짜를 알 수 없는 경우 비어 있습니다. |
state |
출력 전용입니다. 과정의 상태입니다. |
section |
선택사항입니다. 섹션에서 직접 실습해 볼 시간입니다. |
room |
선택사항입니다. 수업의 강의실입니다. |
subject |
선택사항입니다. 과정의 주제입니다. |
gradeLevels |
선택사항입니다. 과정의 학년 수준입니다. |
description |
선택사항입니다. 과정에 관한 설명입니다. |
learningGoals[] |
출력 전용입니다. 이 과정에 연결된 학습 목표입니다. |
LearningGoal
| JSON 표현 |
|---|
{
"id": string,
"type": enum ( |
| 필드 | |
|---|---|
id |
출력 전용입니다. 학습 목표의 ID입니다. 표준을 연결하려면 search_course_standards의 |
type |
출력 전용입니다. 학습 목표의 유형입니다. |
standardCode |
출력 전용입니다. 표준 코드(예: 'NY-2.NBT.4')입니다. 표준에만 채워집니다. |
title |
출력 전용입니다. 표준에 대한 설명 또는 기술에 대한 인간이 읽을 수 있는 제목입니다. |
documentTitle |
출력 전용입니다. 교육과정 문서 이름입니다. 표준에만 채워집니다. |
역할
과정에서 사용자의 역할입니다.
| 열거형 | |
|---|---|
ROLE_UNSPECIFIED |
지정되지 않은 역할입니다. |
TEACHER |
교사 역할 |
COTEACHER |
공동 교사 역할 |
STUDENT |
학생 역할 |
INVITED_OR_INACTIVE |
초대된 역할 또는 비활성 역할입니다. |
주
과정의 상태입니다.
| 열거형 | |
|---|---|
STATE_UNSPECIFIED |
지정되지 않은 상태입니다. |
ACTIVE |
활성 상태입니다. |
ARCHIVED |
보관처리된 상태입니다. |
PROVISIONED |
프로비저닝된 상태입니다. |
유형
학습 목표의 유형입니다.
| 열거형 | |
|---|---|
TYPE_UNSPECIFIED |
지정되지 않은 학습 목표 유형입니다. |
STANDARD |
학술 교육과정의 학습 표준입니다. |
SKILL |
교육 개념 또는 역량을 나타내는 스킬입니다. 클래스룸에서 교사만 기술을 추가하거나 삭제할 수 있습니다. |
도구 주석
도구 주석은 MCP 클라이언트에 전송되어 특정 도구의 기본 위험을 설명합니다. 대부분의 클라이언트는 이러한 힌트를 신뢰할 수 없는 것으로 취급하지만, 사용자에게 확인 메시지를 보낼 시점을 결정하는 데 사용할 수 있습니다.
제목 문자열과 함께 다음 불리언 힌트가 정의됩니다.
readOnlyHint: true인 경우 도구가 환경을 수정하지 않습니다. 기본값: false.destructiveHint: true이면 도구가 파괴적인 작업을 수행할 수 있습니다. false이면 도구는 추가 작업만 수행할 수 있습니다. 기본값은 true입니다.idempotentHint: true인 경우 동일한 인수로 도구를 반복적으로 호출해도 환경에 추가적인 영향을 미치지 않습니다. 기본값: false.openWorldHint: true인 경우 도구는 외부 항목의 '오픈 월드'와 상호작용할 수 있습니다. false이면 도구는 내부 항목과만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.
Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/classroom.courses.readonlyhttps://www.googleapis.com/auth/classroom.rosters.readonly