مشاهده، ایجاد و اصلاح CourseWork در Classroom
چه چیزی می توانم با نقاط پایانی CourseWork در Classroom API بسازم؟
نقاط پایانی جدید به توسعه دهندگان این امکان را می دهد که کار را در یک کلاس مشاهده و مدیریت کنند. به طور خاص، شما می توانید تمام کارهای زیر را انجام دهید:
- مشاهده تکالیف و سوالات (که در مجموع به عنوان "کار درسی" نامیده می شود) برای یک کاربر
- CourseWork را ایجاد، اصلاح و حذف کنید
- مواد (فایل‌های Drive، ویدیوهای YouTube، پیوندها) را به CourseWork پیوست کنید
- تغییر وضعیت ارسال یک دانش آموز (مانند تحویل، بازگشت، درخواست مجدد)
- نمره را برای ارسال تکلیف تعیین کنید
- مطالب (فایل‌های Drive، ویدیوهای YouTube، پیوندها) را به مطالب ارسالی دانش‌آموز پیوست کنید
چند نمونه از موارد استفاده برای CourseWork:
- کتاب‌های نمره، SIS یا سیستم‌های گزارش‌دهی می‌توانند تکالیف و نمرات را از Classroom با برنامه‌های خود همگام‌سازی کنند و انتقال دستی داده را حذف کنند.
- برنامه های آموزشی می توانند تکالیف جدیدی ایجاد کنند که در جریان کلاس ظاهر می شوند. وقتی دانش‌آموزان کار را کامل می‌کنند، برنامه‌ها می‌توانند کار را تحویل دهند، نمره‌ها را تعیین کنند، کار دانش‌آموز را پیوست کنند، و کار را در پوشه‌های Drive مناسب ذخیره کنند.
- کاربران معلم می توانند تکالیفی را با پیوست های افزودنی از وب سایت یا برنامه شما ایجاد کنند.
- کاربران دانش‌آموز می‌توانند تکالیف خود را که دارای پیوست‌های افزودنی شما هستند، تحویل دهند.
برنامه من برای ایجاد یا تغییر تکالیف به چه مجوزهایی نیاز دارد؟
به طور معمول، یک برنامه فقط می تواند کاری را که ایجاد می کند تغییر دهد. به عبارت دیگر، هر درخواست API جهش انتساب باید از همان شناسه پروژه Google Cloud استفاده کند که در زمان ایجاد تخصیص ذخیره شده است.
افزونه های Google Classroom از این قاعده مستثنی هستند. یک پروژه Cloud می‌تواند به هر اعلامیه، تکلیف یا مطلبی که یک یا چند پیوست افزودنی آن را دارد دسترسی داشته باشد یا آن را تغییر دهد. یک پروژه Cloud همچنین می‌تواند تکلیفی را که دارای یک یا چند ضمیمه افزودنی است، تحویل دهد، مطالبه کند یا برگرداند.
درخواست‌های API همچنین به دامنه‌های کاربری صحیح نیاز دارند. معلمان می توانند تکالیف را مشاهده کنند، تکالیف ایجاد کنند، پیوندهایی را به تکالیف ارسالی پیوست کنند و نمرات ارسالی را تنظیم کنند. دانش‌آموزان می‌توانند تکالیف را مشاهده کنند، پیوندهایی را به سوابق تکالیف خود ضمیمه کنند، و مطالب ارسالی خود را تحویل داده و پس بگیرند. مدیران دامنه می توانند CourseWork را مشاهده کنند، اما هیچ مجوز نوشتن ندارند.
درخواست من چه نوع مواردی را می تواند به تکلیف یا ارسالی ضمیمه کند؟
API از پیوست کردن فایل‌های Drive، ویدیوهای YouTube و پیوندها پشتیبانی می‌کند. پیوست کردن Google Forms بومی هنوز پشتیبانی نمی‌شود.
آیا کاربران نهایی می دانند که یک تکالیف در Classroom توسط برنامه من ایجاد شده است؟
آره. رابط کاربری Classroom با استفاده از نام محصول پروژه Google Cloud که کار را ایجاد کرده است، تکالیف ایجاد شده خارجی را شناسایی می کند. کاربران می توانند کار ایجاد شده خارجی را به عنوان ناخواسته گزارش کنند و همچنین با لغو هر گونه اعتبار صادر شده برای برنامه توسط کاربر، ارتباط برنامه ای را که کار را ایجاد کرده است، قطع کنند.
دکمه اشتراک‌گذاری کلاس و سایر ادغام‌ها
من قبلاً با دکمه اشتراک‌گذاری Classroom یکپارچه شده‌ام. آیا می توانم یک تکلیف ایجاد شده با استفاده از دکمه اشتراک گذاری را تغییر دهم؟
نه هنوز. برای اصلاح یک تکلیف، درخواست باید از همان پروژه Google Cloud استفاده کند که تخصیص را ایجاد کرده است.
آیا می توانم به سوالات در API پاسخ دهم؟
نه هنوز. شما می توانید سوالات را ایجاد و اصلاح کنید. پاسخ دادن به سوالات به صورت برنامه ای در نقشه راه ما است.
افزونه های کلاس درس
پیکربندی پروژه
آیا می توانم پروژه خصوصی Google Cloud را که در طول توسعه استفاده کردم به پروژه عمومی که می توانم در تولید استفاده کنم تبدیل کنم؟
شما نمی توانید یک پروژه خصوصی Google Cloud را به یک پروژه عمومی تبدیل کنید. شما به دو پروژه جداگانه نیاز دارید، یکی برای توسعه و دیگری برای تولید.
آیا یک پروژه Google Cloud می تواند دو لیست GWM داشته باشد؟
نه. شما نمی توانید دو لیست GWM برای یک پروژه Google Cloud ایجاد کنید.
با این حال، امکان بسته‌بندی افزونه‌ها وجود دارد. انجام این کار به یک لیست GWM اجازه می دهد تا چندین افزونه را نشان دهد. نصب از چنین فهرستی تمام افزونه های موجود در بسته را به یکباره نصب می کند. هنگام صدور مجوز، کاربران باید با همه حوزه‌های مورد نیاز افزونه‌های همراه موافقت کنند.
دو ملاحظات دیگر در مورد بسته بندی وجود دارد:
افزونه‌های کلاس فقط برای مشترکین ارتقای آموزش و یادگیری یا Education Plus SKU در دسترس هستند.
API افزونه‌ها در دسترسی زودهنگام است و به توسعه‌دهندگان شرکت‌کننده و پروژه‌های Google Cloud محدود می‌شود. اگر افزونه‌های بسته‌شده به پروژه‌های Google Cloud غیر مشارکتی متکی باشند، ممکن است آنطور که در نظر گرفته شده کار نکنند.
آیا می توان از یک سرویس گیرنده OAuth از پروژه Google Cloud دیگری با پروژه Google Cloud برای افزونه های Classroom استفاده مجدد کرد؟
خیر، یک سرویس گیرنده OAuth از پروژه Google Cloud غیر از پروژه Google Cloud برافزای Classroom نمی‌تواند کار کند. توکن‌های دسترسی تولید شده توسط پروژه Google Cloud دیگر توسط API Classroom رد می‌شوند. شما باید یک سرویس گیرنده OAuth جداگانه برای پروژه الحاقی ایجاد کنید.
تجربه ی کاربر
لوگوی ما به خوبی در یک مربع کوچک جا نمی‌شود، چه گزینه‌هایی برای لوگوها در نوار عنوان iframe وجود دارد؟
نوار عنوان iframe فقط برای پشتیبانی از لوگوی مربعی 32x32 طراحی شده است. این انتخاب برای مطابقت با شکل فاویکونی که شرکت‌ها در وب‌سایت‌های خود استفاده می‌کنند انجام شده است و راهنمایی ما برای استفاده از همان آرم در فضا برای ثبات برند است.
دامنه ها
آیا همه معلمان و دانش آموزان در یک دامنه به یک افزونه نصب شده دسترسی دارند؟
مدیران مدرسه این توانایی را دارند که کنترل کنند کدام معلمان می توانند افزونه نصب شده را ببینند.
مدیران دامنه چگونه با افزونه ها تعامل دارند؟
مدیران دامنه (Administrators) کنترل می کنند که چه کسی می تواند از افزونه شما استفاده کند. آنها می توانند با استفاده از گزینه نصب مدیر، یک افزونه برای کل دامنه نصب کنند. اگر افزونه شما می تواند به صورت جداگانه نصب شود، توجه داشته باشید که اکثر مدیران یک لیست مجاز افزودنی دارند. معلمان می توانند افزونه هایی را که در این لیست هستند برای خود نصب کنند. یک سرپرست همچنین ممکن است تصمیم بگیرد که افزونه شما را به صورت جداگانه برای اهداف آزمایش نصب کند.
مدیران همچنین ممکن است به آمار استفاده در مورد افزونه شما علاقه مند باشند. اگر توسط محصول شما پشتیبانی می‌شود، آمار استفاده از افزونه را در نمای سرپرست در سایت خود ارائه دهید.
API
راه مطمئنی برای دانستن اینکه آیا صفحه شریک در داخل یک iframe یا یک برگه بازشو بارگذاری شده است چیست؟
هیچ روش فعلی برای تمایز بین این دو وجود ندارد.
کدام موارد کاری قابل تخصیص iframe بررسی کار دانشجویی می‌شود؟
iframe Student Work Review فقط برای پیوست‌های نوع فعالیت ارائه شده است. با متد courses.courseWork.getAddOnContext تماس بگیرید تا مشخص شود آیا نوع پست از کار دانشجو پشتیبانی می کند یا خیر. فیلد supportsStudentWork فقط برای یک نوع پست که یک فعالیت است می تواند true باشد.
آیا در طول برنامه دسترسی زودهنگام می توان تغییرات قطعی در API ایجاد کرد؟
API افزودنی هنوز در حال توسعه است. بنابراین، ممکن است تغییرات قطعی در API وجود داشته باشد که باعث شود درخواست‌های موفق قبلی شکست بخورند یا رفتار متفاوتی داشته باشند. می‌توانید از قبل از طریق انجمن توسعه‌دهندگان از هرگونه تغییر قطعی مطلع شوید.
آیا یک پیوست افزودنی می تواند به آیتم جریانی که به آن پیوست شده است دسترسی داشته باشد؟
آره. می‌توانید هر Announcement ، CourseWork ، یا CourseWorkMaterial را که حداقل یکی از پیوست‌های افزودنی شما را شامل می‌شود، get یا وصله patch . شما می توانید reclaim ، return یا ارائه یک CourseWork StudentSubmission turnIn .
چه زمانی افزونه های Classroom به صورت عمومی منتشر می شوند؟
افزونه‌های Classroom از تابستان 2022 برای همه کاربران نهایی در دسترس هستند. انتظار می‌رود API افزونه‌ها در سال 2024 به طور کلی در دسترس توسعه‌دهندگان قرار گیرد.
Single Sign-On
آیا دانش‌آموزانی که از نشان‌های هوشمند یا Classlink برای ورود به Chromebook خود استفاده می‌کنند، می‌توانند از ورود به سیستم Google استفاده کنند؟
بله، آنها همچنان می توانند از Google Sign-In استفاده کنند.
آیا هر دانش آموزی حتی اگر به جیمیل دسترسی نداشته باشد، آدرس ایمیل درستی دارد؟
هر کاربر Google Workspace for Education بدون در نظر گرفتن اینکه آیا به Gmail دسترسی دارد یا خیر، یک هویت Google دارد. هویت ها با یک آدرس ایمیل نشان داده می شوند. هویت و دسترسی به هر سرویس خاص Google (از جمله Gmail) متمایز است. بنابراین، حتی اگر جیمیل غیرفعال باشد، کاربران دانشجو می توانند با آدرس ایمیل خود وارد شوند.
آیا مدیر مدرسه باید برنامه را از قبل تأیید کند تا به دانش آموزان اجازه ورود به سیستم بدهد؟
مدیران دامنه باید یک افزونه را قبل از نصب آن لیست کنند . به صورت اختیاری، مدیران دامنه می توانند افزونه ای را برای همه کاربران داخل دامنه یا یک واحد سازمانی نصب کنند.
بازخورد و سوالات عمومی
چگونه می توانم درخواست های ویژگی یا درخواست مشکلات را ارسال کنم؟
می‌توانید درخواست‌های ویژگی را در ردیاب مسائل عمومی ما ارسال کنید، مشاهده کنید، و به آنها رأی دهید.
چگونه می توانم بدانم که ویژگی های جدید در Classroom API موجود است؟
به‌روزرسانی‌های API در صفحه یادداشت‌های انتشار ، انجمن توسعه‌دهندگان ما و ردیاب مسائل عمومی پست می‌شوند.
من از Classroom API استفاده می کنم. چگونه می توانم سوالات فنی بپرسم؟
سوالات خود را با برچسب google-classroom در Stack Overflow ارسال کنید.