استراتژی پیاده سازی

این صفحه نمای کلی کوتاهی از تعاملات کلیدی بین برنامه وب افزودنی شما و 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 برای شناسایی جدیدترین نسخه ای که افزونه از آن آگاه است استفاده کنید و تنظیمات را از آن کپی کنید تا یک مدل متناظر جدید از پیوست در سمت افزونه ایجاد کنید. سپس، رابط کاربری پیوست مناسب را نشان دهید.