این صفحه نمای کلی کوتاهی از تعاملات کلیدی بین برنامه وب افزودنی شما و API افزونه های Google Classroom ارائه می دهد.
iframe کشف پیوست
iframe کشف پیوست صفحه مقصد معلمان در افزونه شما است. اقدامات زیر را در رابطه با این دیدگاه در نظر بگیرید:
رابط کاربری کشف یا ایجاد محتوای خود را نشان دهید.
به صورت اختیاری، تعیین کنید که آیا مورد جریان پاسخهای دانشآموز را میپذیرد، زیرا ممکن است بخواهید از افزودن پیوستهای نوع فعالیت توسط معلم جلوگیری کنید. مقدار پارامتر query
itemType
را که هنگام باز شدن افزونه iframed ارسال شد، بررسی کنید. فقط نوعcourseWork
پاسخ های دانشجو را می پذیرد.بر اساس انتخاب معلم، یک یا چند افزونه
create
درخواست برای افزودن پیوست به تکلیف ایجاد کنید.
سایر آیفریم ها
iframe Student View ، Student Work Review iframe و Teacher View iframe همگی برای ارائه محتوا به کاربر بهجای تغییر تکلیف Classroom هستند. اقدامات زیر را در رابطه با این دیدگاه ها در نظر بگیرید:
- وقتی یک iframe باز میشود، رضایت OAuth کاربر را دریافت کنید و سپس نقش و شناسه پیوست او را تأیید کنید.
- وقتی یک iframe باز میشود، یک
courseWork.GetAddOnContextRequest
،courseWorkMaterials.GetAddOnContextRequest
یاannouncements.GetAddOnContextRequest
.GetAddOnContextRequest را بر اساسitemType
ایجاد کنید تا نقش کاربر را تأیید کنید. - اگر کاربر فعلی دانشجو است،
submissionId
از پاسخ را با کار دانشجویی مرتبط کنید. این برای گذراندن نمرات عقب و برای نشان دادن کار دانش آموزان به معلمان در ابزار درجه بندی مورد نیاز است.submissionIds
با بازدیدها مطابقت دارد. - اگر
attachmentId
قبلاً برای افزونه شناخته شده است، رابط کاربری پیوست مناسب را نشان دهید. - در غیر این صورت حتماً پست اصلی این پیوست از پست یا دوره دیگری کپی شده است. از
copyHistory
برای شناسایی جدیدترین نسخه ای که افزونه از آن آگاه است استفاده کنید و تنظیمات را از آن کپی کنید تا یک مدل متناظر جدید از پیوست در سمت افزونه ایجاد کنید. سپس، رابط کاربری پیوست مناسب را نشان دهید.
این صفحه نمای کلی کوتاهی از تعاملات کلیدی بین برنامه وب افزودنی شما و API افزونه های Google Classroom ارائه می دهد.
iframe کشف پیوست
iframe کشف پیوست صفحه مقصد معلمان در افزونه شما است. اقدامات زیر را در رابطه با این دیدگاه در نظر بگیرید:
رابط کاربری کشف یا ایجاد محتوای خود را نشان دهید.
به صورت اختیاری، تعیین کنید که آیا مورد جریان پاسخهای دانشآموز را میپذیرد، زیرا ممکن است بخواهید از افزودن پیوستهای نوع فعالیت توسط معلم جلوگیری کنید. مقدار پارامتر query
itemType
را که هنگام باز شدن افزونه iframed ارسال شد، بررسی کنید. فقط نوعcourseWork
پاسخ های دانشجو را می پذیرد.بر اساس انتخاب معلم، یک یا چند افزونه
create
درخواست برای افزودن پیوست به تکلیف ایجاد کنید.
سایر آیفریم ها
iframe Student View ، Student Work Review iframe و Teacher View iframe همگی برای ارائه محتوا به کاربر بهجای تغییر تکلیف Classroom هستند. اقدامات زیر را در رابطه با این دیدگاه ها در نظر بگیرید:
- وقتی یک iframe باز میشود، رضایت OAuth کاربر را دریافت کنید و سپس نقش و شناسه پیوست او را تأیید کنید.
- وقتی یک iframe باز میشود، یک
courseWork.GetAddOnContextRequest
،courseWorkMaterials.GetAddOnContextRequest
یاannouncements.GetAddOnContextRequest
.GetAddOnContextRequest را بر اساسitemType
ایجاد کنید تا نقش کاربر را تأیید کنید. - اگر کاربر فعلی دانشجو است،
submissionId
از پاسخ را با کار دانشجویی مرتبط کنید. این برای گذراندن نمرات عقب و برای نشان دادن کار دانش آموزان به معلمان در ابزار درجه بندی مورد نیاز است.submissionIds
با بازدیدها مطابقت دارد. - اگر
attachmentId
قبلاً برای افزونه شناخته شده است، رابط کاربری پیوست مناسب را نشان دهید. - در غیر این صورت حتماً پست اصلی این پیوست از پست یا دوره دیگری کپی شده است. از
copyHistory
برای شناسایی جدیدترین نسخه ای که افزونه از آن آگاه است استفاده کنید و تنظیمات را از آن کپی کنید تا یک مدل متناظر جدید از پیوست در سمت افزونه ایجاد کنید. سپس، رابط کاربری پیوست مناسب را نشان دهید.