כלי: create_topic
יצירת נושא חדש בקורס. הנושאים משמשים לארגון העבודה לכיתה. נדרש תפקיד של מורה בקורס.
בדוגמת הקוד הבאה מוסבר איך להשתמש ב-curl כדי להפעיל את כלי ה-MCP create_topic.
| בקשת 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 }' |
סכימת הקלט
בקשה ליצור נושא בקורס.
CreateTopicRequest
| ייצוג ב-JSON |
|---|
{ "courseId": string, "title": string } |
| שדות | |
|---|---|
courseId |
חובה. המזהה של הקורס. |
title |
חובה. שם הנושא. האורך המקסימלי הוא 100 תווים. |
סכימת הפלט
נושא בקורס.
נושא
| ייצוג ב-JSON |
|---|
{ "id": string, "title": string } |
| שדות | |
|---|---|
id |
פלט בלבד. מזהה. מזהה הנושא. |
title |
שם הנושא. |
הערות לגבי הכלים
הערות לגבי כלים נשלחות ללקוחות 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.topics