MCP Tools Reference: classroommcp.googleapis.com

ابزار: search_course_standards

استانداردهای یادگیری آکادمیک را در دوره‌ای جستجو می‌کند تا به کار کلاسی یا راهنمای ارزیابی برچسب بزند. لازم است دوره دارای استانداردهای یادگیری پیکربندی‌شده توسط معلم باشد.

  • استانداردهای خاص: جستجو با کد دقیق (مثلاً «HS-LS1-1») یا کلیدواژه‌های خاص (includeGroupingStandards=false).
  • دسته‌ها: includeGroupingStandards=true را با کلمه موضوعی گسترده تنظیم کنید تا دسته‌های اصلی را پیدا کنید، سپس شناسه دسته را به learningStandardIds منتقل کنید تا نتایج را محدود کنید.

نمونه کد زیر نحوه استفاده از curl برای فراخوانی ابزار MCP search_course_standards را نشان می‌دهد.

درخواست 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": "search_course_standards",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

طرح‌واره ورودی

درخواست جستجو در درخت‌های استاندارد یادگیری سطح دوره ازپیش انتخاب‌شده.

SearchCourseStandardsRequest

نمایش JSON
{
  "courseId": string,
  "learningStandardIds": [
    string
  ],
  "query": string,
  "includeGroupingStandards": boolean
}
فیلدها
courseId

string

الزامی. شناسه دوره.

learningStandardIds[]

string

اختیاری. جستجو را به این مجموعه‌های استاندارد یا استانداردهای دسته و موارد مشتق‌شده از آن‌ها محدود می‌کند. یا شناسه مجموعه استاندارد از Course.learning_goals (در list_courses) یا شناسه‌های دسته از تماس قبلی با includeGroupingStandards = true (نه standardCode) را ارسال کنید، نه هر دو را. اگر خالی باشد، همه استانداردهای دوره را جستجو می‌کند.

query

string

الزامی. عبارت‌های جستجو به حروف بزرگ و کوچک حساس نیستند؛ نتایج باید شامل همه کلمه‌های جداشده با فاصله در کد یا عبارت باشند. - وقتی includeGroupingStandards = false: یک کد استاندارد دقیق (مثلاً «HS-LS1-1») یا ۲ تا ۳ کلیدواژه خاص (مثلاً «area triangles») را ارسال کنید. - وقتی includeGroupingStandards = true: یک یا دو کلمه دامنه گسترده (مثلاً «هندسه») را که با عنوان‌های دسته مطابقت دارد ارسال کنید.

includeGroupingStandards

boolean

اختیاری. اگر درست باشد، سرصفحه‌های دسته‌ای را برمی‌گرداند (نمی‌توان به کار کلاسی برچسب زد) که شناسه‌هایشان جستجوهای پیگیری را محدود می‌کند. اگر نادرست باشد (پیش‌فرض)، استانداردهایی را برمی‌گرداند که می‌توانند در کار کلاسی برچسب‌گذاری شوند.

طرح برونداد

پاسخ حاوی استانداردهای یادگیری.

SearchCourseStandardsResponse

نمایش JSON
{
  "learningStandards": [
    {
      object (LearningGoal)
    }
  ]
}
فیلدها
learningStandards[]

object (LearningGoal)

فهرست استانداردهای منطبق.

LearningGoal

نمایش JSON
{
  "id": string,
  "type": enum (Type),
  "standardCode": string,
  "title": string,
  "documentTitle": string
}
فیلدها
id

string

فقط خروجی. شناسه هدف یادگیری. برای پیوست کردن استاندارد، از id از search_course_standards (نه standardCode) استفاده کنید.

type

enum (Type)

فقط خروجی. نوع هدف یادگیری.

standardCode

string

فقط خروجی. کد استاندارد (مثلاً «NY-2.NBT.4»). فقط برای استانداردها درج می‌شود.

title

string

فقط خروجی. شرح بیانیه برای استانداردها، یا عنوان قابل‌خواندن برای انسان برای مهارت‌ها.

documentTitle

string

فقط خروجی. نام سند برنامه درسی. فقط برای استانداردها درج می‌شود.

نوع

نوع هدف یادگیری.

شمارشی‌ها
TYPE_UNSPECIFIED نوع هدف یادگیری نامشخص است.
STANDARD استاندارد یادگیری از برنامه درسی دانشگاهی.
SKILL مهارتی که نشان‌دهنده یک مفهوم یا شایستگی آموزشی است. فقط معلم می‌تواند مهارت‌ها را در Classroom اضافه یا حذف کند.

حاشیه‌نویسی‌های ابزار

حاشیه‌نویسی‌های ابزار به کارخواهان MCP ارسال می‌شود تا خطر اصلی ابزار موردنظر را شرح دهد. اکثر کارخواه‌ها این راهنمایی‌ها را غیرقابل‌اعتماد تلقی می‌کنند، اما می‌توان از آن‌ها برای تصمیم‌گیری درباره زمان ارسال پیام‌واره تأیید به کاربر استفاده کرد.

همراه با رشته عنوان، نکات بولی زیر به‌صورت زیر تعریف می‌شوند:

  • ‫readOnlyHint: اگر درست باشد، ابزار محیط خود را تغییر نمی‌دهد. پیش‌فرض: false.
  • ‫destructiveHint: اگر درست باشد، ابزار می‌تواند کنش‌های مخرب انجام دهد. اگر نادرست باشد، ابزار فقط می‌تواند کنش‌های افزایشی انجام دهد. پیش‌فرض: true.
  • idempotentHint: اگر درست باشد، فراخوانی مکرر ابزار با همان متغیرهای مستقل تأثیر بیشتری بر محیط آن نخواهد داشت. پیش‌فرض: false.
  • ‫openWorldHint: اگر درست باشد، ابزار می‌تواند با «دنیای باز» نهادهای خارجی تعامل داشته باشد. اگر نادرست باشد، ابزار فقط می‌تواند با نهادهای داخلی تعامل داشته باشد. برای مثال، ابزار جستجوی وب از نوع دنیای باز است، درحالی‌که ابزار حافظه از نوع دنیای باز نیست.

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

دامنه‌های مجوز

به یکی از دامنه‌های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/classroom.courses
  • https://www.googleapis.com/auth/classroom.courses.readonly