Araç: list_courses
Kullanıcının derslerini ayrıntılarıyla (bölüm, oda, konu, sınıf düzeyleri, açıklama, öğrenme hedefleri, durum ve kullanıcının rolü) listeler. Kursları keşfetmek ve kimliklerini almak için bunu birincil giriş noktası olarak kullanın. Dersler genellikle aynı başlığa sahip olduğundan bunları ayırt etmek için bölümü kullanın. courseState ayarlanmadığı sürece (ör. ARCHIVED) yalnızca ACTIVE kursları döndürür.
Kullanıcıyı Classroom web uygulamasındaki bir kursa bağlamak için https://classroom.google.com/c/{course_id} (akış) veya https://classroom.google.com/w/{course_id}/t/all (Sınıf Çalışmaları sayfası) bağlantısını kullanın. Kimlikleri tam olarak döndürüldüğü şekilde kullanın. Kimlikleri asla tahmin etmeyin veya değiştirmeyin.
Aşağıdaki kod örneğinde, list_courses MCP aracını çağırmak için curl öğesinin nasıl kullanılacağı gösterilmektedir.
| Curl İsteği |
|---|
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 }' |
Giriş şeması
Kursları listeleme isteği.
ListCoursesRequest
| JSON gösterimi |
|---|
{ "courseState": enum ( |
| Alanlar | |
|---|---|
courseState |
İsteğe bağlıdır. Ders durumuna göre filtreleme Varsayılan değer |
createdDateRange |
İsteğe bağlıdır. Oluşturma tarihlerinin aralığına göre filtreleyin. |
timeZone |
Zorunlu. Kullanıcının IANA saat dilimi (ör. |
titleContains |
İsteğe bağlıdır. Başlığı büyük/küçük harfe duyarlı olmayan alt dizeye göre filtreleyin. |
pageSize |
İsteğe bağlıdır. Sayfa boyutunu kontrol eder. Varsayılan değer 10, maksimum değer 50'dir. |
pageToken |
İsteğe bağlıdır. Sayfalara ayırma jetonu. |
DateRange
| JSON gösterimi |
|---|
{ "startDate": string, "endDate": string } |
| Alanlar | |
|---|---|
startDate |
Aralığın başlangıç zamanı dahildir (biçim: YYYY-AA-GG). |
endDate |
Aralığın dahil edilen bitiş tarihi (biçim: YYYY-AA-GG). |
Eyalet
Kursun durumları.
| Sıralamalar | |
|---|---|
STATE_UNSPECIFIED |
Belirtilmemiş durum. |
ACTIVE |
Etkin durumda. |
ARCHIVED |
Arşivlenmiş durum. |
PROVISIONED |
Temel hazırlığı yapılmış durum. |
Çıkış şeması
Kursları listeleme isteğinin yanıtı.
ListCoursesResponse
| JSON gösterimi |
|---|
{
"courses": [
{
object ( |
| Alanlar | |
|---|---|
courses[] |
Kursların listesi. |
nextPageToken |
Sonraki sayfa jetonu. |
Kurs
| JSON gösterimi |
|---|
{ "id": string, "title": string, "role": enum ( |
| Alanlar | |
|---|---|
id |
Tanımlayıcı. Bu dersin tanımlayıcısı. |
title |
Kursun başlığı. |
role |
Kullanıcının bu dersteki rolü. |
creationDate |
Kursun oluşturulma tarihi (biçim: YYYY-AA-GG). Oluşturma tarihi bilinmiyorsa boş bırakılır. |
state |
Yalnızca çıkış. Kursun durumu. |
section |
İsteğe bağlıdır. Kursun bölümü. |
room |
İsteğe bağlıdır. Kursun odası. |
subject |
İsteğe bağlıdır. Kursun konusu. |
gradeLevels |
İsteğe bağlıdır. Kursun sınıf düzeyleri. |
description |
İsteğe bağlıdır. Kursun açıklaması. |
learningGoals[] |
Yalnızca çıkış. Bu kursa eklenen öğrenme hedefleri. |
LearningGoal
| JSON gösterimi |
|---|
{
"id": string,
"type": enum ( |
| Alanlar | |
|---|---|
id |
Yalnızca çıkış. Öğrenme hedefinin kimliği. Standart eklemek için search_course_standards'dan bir |
type |
Yalnızca çıkış. Öğrenme hedefinin türü. |
standardCode |
Yalnızca çıkış. Standart kod (ör. "NY-2.NBT.4"). Yalnızca standartlar için doldurulur. |
title |
Yalnızca çıkış. Standartlar için ifade açıklaması veya beceriler için kullanıcılar tarafından okunabilir başlık. |
documentTitle |
Yalnızca çıkış. Müfredat dokümanı adı. Yalnızca standartlar için doldurulur. |
Rol
Kullanıcının bir dersteki rolleri.
| Sıralamalar | |
|---|---|
ROLE_UNSPECIFIED |
Belirtilmemiş rol. |
TEACHER |
Öğretmen rolü. |
COTEACHER |
Yardımcı öğretmen rolü. |
STUDENT |
Öğrenci rolü |
INVITED_OR_INACTIVE |
Davet edilen veya etkin olmayan rol. |
Eyalet
Kursun durumları.
| Sıralamalar | |
|---|---|
STATE_UNSPECIFIED |
Belirtilmemiş durum. |
ACTIVE |
Etkin durumda. |
ARCHIVED |
Arşivlenmiş durum. |
PROVISIONED |
Temel hazırlığı yapılmış durum. |
Tür
Öğrenme hedefinin türü.
| Sıralamalar | |
|---|---|
TYPE_UNSPECIFIED |
Öğrenme hedefi türü belirtilmemiş. |
STANDARD |
Akademik müfredattaki bir öğrenme standardı. |
SKILL |
Eğitimle ilgili bir kavramı veya yeterliliği temsil eden beceri. Classroom'da yalnızca öğretmenler beceri ekleyebilir veya kaldırabilir. |
Araç Notları
Araç ek açıklamaları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilir olarak değerlendirmez ancak kullanıcıya ne zaman onay istemi gönderileceğine karar vermek için kullanılabilir.
Başlık dizesiyle birlikte aşağıdaki boole ipuçları şu şekilde tanımlanır:
readOnlyHint: Doğru ise araç, ortamını değiştirmez. Varsayılan: false.destructiveHint: Doğru ise araç, yıkıcı işlemler gerçekleştirebilir. "False" ise araç yalnızca ekleme işlemleri gerçekleştirebilir. Varsayılan: true.idempotentHint: Doğru ise aracın aynı bağımsız değişkenlerle tekrar tekrar çağrılması, ortamı üzerinde ek bir etki yaratmaz. Varsayılan: false.openWorldHint: Doğru ise araç, harici varlıkların "açık dünyası" ile etkileşime girebilir. Yanlış ise araç yalnızca dahili varlıklarla etkileşim kurabilir. Örneğin, web arama aracı açık dünya iken bellek aracı açık dünya değildir.
Yıkıcı İpucu: ❌ | Aynı Sonucu Veren İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌
Yetkilendirme Kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/classroom.courses.readonlyhttps://www.googleapis.com/auth/classroom.rosters.readonly