مشاهده، ایجاد و اصلاح CourseWork در کلاس درس
با نقاط پایانی CourseWork در Classroom API چه چیزهایی میتوانم بسازم؟
نقاط پایانی به توسعهدهندگان اجازه میدهند تا کار را در یک کلاس مشاهده و مدیریت کنند. به طور خاص، میتوانید تمام موارد زیر را انجام دهید:
- مشاهده تکالیف و سوالات (که در مجموع به عنوان
CourseWorkشناخته میشوند) برای یک کاربر. - ایجاد، اصلاح و حذف
CourseWork. - مطالب (فایلهای Drive، ویدیوهای YouTube، لینکها) را به
CourseWorkپیوست کنید. - وضعیت ارائه دانشجو (مانند تحویل، بازگشت، بازپسگیری) را تغییر دهید.
- نمره برای ارسال تکلیف را تعیین کنید.
- مطالب (فایلهای Drive، ویدیوهای YouTube، لینکها) را به مطالب ارسالی دانشآموزان پیوست کنید.
برخی از موارد استفاده نمونه برای CourseWork :
- دفاتر نمره، SIS یا سیستمهای گزارشدهی میتوانند تکالیف و نمرات را از Classroom با برنامههای خود همگامسازی کنند و انتقال دستی دادهها را از بین ببرند.
- برنامههای یادگیری میتوانند تکالیف جدیدی ایجاد کنند که در جریان کلاس ظاهر میشوند. همزمان با تکمیل کار دانشآموزان، برنامهها میتوانند کار را تحویل دهند، نمرات را تعیین کنند، کار دانشآموزان را پیوست کنند و کار را در پوشههای مناسب Drive ذخیره کنند.
- کاربران معلم میتوانند تکالیف را با پیوستهای افزونه از وبسایت یا برنامه شما ایجاد کنند.
- کاربران دانشجویی میتوانند تکالیف خود را که پیوستهای افزونه شما را دارند، تحویل دهند.
برنامه من برای ایجاد یا تغییر تکالیف به چه مجوزهایی نیاز دارد؟
معمولاً، یک برنامه فقط میتواند کاری را که ایجاد میکند تغییر دهد. به عبارت دیگر، هر درخواست API برای تغییر CourseWork باید از همان شناسه پروژه Google Cloud که برای ایجاد CourseWork استفاده شده است، استفاده کند.
افزونههای کلاس درس گوگل از این قاعده مستثنی هستند. یک پروژه ابری میتواند به هر اطلاعیه، تکلیف یا مطالبی که یک یا چند پیوست افزونه دارد، دسترسی داشته باشد یا آنها را تغییر دهد. یک پروژه ابری همچنین میتواند تکلیفی را که یک یا چند پیوست افزونه دارد، تحویل دهد، پس بگیرد یا برگرداند.
درخواستهای API همچنین به محدودههای کاربری صحیح نیاز دارند. معلمان میتوانند تکالیف را مشاهده کنند، تکالیف ایجاد کنند، لینکهایی را به ارسال تکالیف پیوست کنند و نمرات تکالیف را تنظیم کنند. دانشآموزان میتوانند تکالیف را مشاهده کنند، لینکهایی را به سوابق تکالیف خود پیوست کنند و تکالیف خود را تحویل داده و پس بگیرند. مدیران دامنه میتوانند CourseWork مشاهده کنند، اما مجوز نوشتن ندارند.
چه نوع مواردی را میتوانم به تکالیف یا مقالات ارسالی ضمیمه کنم؟
این API از پیوست کردن فایلهای Drive، ویدیوهای YouTube و لینکها پشتیبانی میکند. پیوست کردن فرمهای Google بومی هنوز پشتیبانی نمیشود.
آیا کاربران نهایی میدانند که یک تکلیف در Classroom توسط برنامه من ایجاد شده است؟
بله. رابط کاربری Classroom تکالیف ایجاد شده خارجی را با استفاده از نام محصول پروژه Google Cloud که اثر را ایجاد کرده است، شناسایی میکند. کاربران میتوانند کارهای ایجاد شده خارجی را به عنوان ناخواسته گزارش دهند، و همچنین با لغو هرگونه اعتبارنامهای که توسط کاربر به برنامه داده شده است، ارتباط برنامهای که اثر را ایجاد کرده است را قطع کنند.
دکمه اشتراکگذاری کلاس درس و سایر ادغامها
من قبلاً دکمه اشتراکگذاری کلاس درس را فعال کردهام. آیا میتوانم تکلیفی را که با استفاده از دکمه اشتراکگذاری ایجاد شده است، تغییر دهم؟
هنوز نه. برای تغییر یک تکلیف، درخواست باید از همان پروژه Google Cloud که تکلیف را ایجاد کرده است، استفاده کند.
آیا میتوانم به سوالات در API پاسخ دهم؟
هنوز نه. میتوانید سوالات را ایجاد و اصلاح کنید.
افزونههای کلاس درس
پیکربندی پروژه
آیا میتوانم یک پروژه خصوصی گوگل کلود را که در طول توسعه استفاده کردهام، به یک پروژه عمومی تبدیل کنم که بتوانم در مرحله تولید از آن استفاده کنم؟
نه، شما نمیتوانید یک پروژه خصوصی گوگل کلود را به یک پروژه عمومی تبدیل کنید. شما به دو پروژه جداگانه نیاز دارید، یکی برای توسعه و دیگری برای تولید.
آیا یک پروژه Google Cloud میتواند دو لیست Google Workspace Marketplace داشته باشد؟
خیر. شما نمیتوانید برای یک پروژه Google Cloud، دو آگهی در Google Workspace Marketplace ایجاد کنید.
با این حال، میتوان افزونهها را به صورت گروهی (Bundle ) ارائه کرد. انجام این کار به یک فهرست واحد از بازار Google Workspace اجازه میدهد تا چندین افزونه را نمایش دهد. نصب از چنین فهرستی، تمام افزونههای موجود در بسته را به طور همزمان نصب میکند. کاربران هنگام تأیید باید با تمام محدودههای مورد نیاز افزونههای گروهی موافقت کنند.
آیا میتوان از یک کلاینت OAuth از یک پروژه Google Cloud دیگر با یک پروژه Google Cloud برای افزونههای Classroom دوباره استفاده کرد؟
خیر، یک کلاینت OAuth از یک پروژه Google Cloud غیر از افزونه Classroom در پروژه Google Cloud نمیتواند کار کند. توکنهای دسترسی تولید شده توسط یک پروژه Google Cloud دیگر توسط Classroom API رد میشوند. شما باید یک کلاینت OAuth جداگانه برای پروژه افزونه ایجاد کنید.
تجربه کاربری
لوگوی ما به خوبی در یک مربع کوچک جا نمیشود، چه اندازههایی برای لوگوها در نوار عنوان iframe افزونههای Classroom وجود دارد؟
نوار عنوان iframe طوری طراحی شده بود که فقط از لوگوی مربعی ۳۲x۳۲ پشتیبانی کند. این انتخاب برای مطابقت با شکل فاوآیکون (favicon) که شرکتها در وبسایتهای خود استفاده میکنند، انجام شده است و راهنمایی ما این است که برای حفظ ثبات برند، از لوگوی یکسانی در این فضا استفاده کنیم.
دامنهها
آیا همه معلمان و دانشآموزان در یک دامنه به افزونه نصب شده دسترسی دارند؟
مدیران دامنه میتوانند کنترل کنند که کدام معلمان میتوانند افزونههای نصب شده را ببینند. افزونههای کلاس درس فقط توسط کاربرانی که دارای مجوز Teaching & Learning یا Education Plus هستند قابل استفاده هستند.
مدیران دامنه چگونه با افزونهها تعامل دارند؟
مدیران دامنه کنترل میکنند که چه کسی میتواند از افزونه شما استفاده کند. آنها میتوانند با استفاده از گزینه نصب مدیر، افزونهای را برای کل دامنه نصب کنند. اگر افزونه شما به صورت جداگانه قابل نصب باشد، توجه داشته باشید که اکثر مدیران یک لیست مجاز برای افزونه دارند؛ معلمانی که در این لیست هستند میتوانند افزونهها را برای خود نصب کنند. یک مدیر همچنین ممکن است برای اهداف آزمایشی، افزونه شما را به صورت جداگانه نصب کند.
مدیران سایت همچنین ممکن است به آمار استفاده از افزونه شما علاقهمند باشند. در صورت پشتیبانی محصول شما، ارائه آمار استفاده از افزونه را در نمای مدیر سایت خود در نظر بگیرید.
رابط برنامهنویسی کاربردی
چه راه مطمئنی برای فهمیدن اینکه محتوای افزونهها داخل iframe یا یک تب جدید بارگذاری شده است، وجود دارد؟
در حال حاضر هیچ روش مشخصی برای تشخیص این دو از هم وجود ندارد.
کدام موارد کاری قابل واگذاری، iframe مربوط به بررسی کار دانشآموز را دریافت میکنند؟
iframe مربوط به بررسی کار دانشجویی فقط برای پیوستهای نوع فعالیت ارائه میشود. برای نمایش اینکه آیا نوع پست از کار دانشجویی پشتیبانی میکند یا خیر ، متد courses.courseWork.getAddOnContext را فراخوانی کنید. فیلد supportsStudentWork فقط برای نوع پستی که یک فعالیت است، میتواند true داشته باشد.
آیا یک افزونهی پیوست میتواند به آیتمی که به آن پیوست شده است دسترسی داشته باشد؟
بله. شما میتوانید هر Announcement ، CourseWork یا CourseWorkMaterial را که حداقل یکی از پیوستهای افزونه شما را دارد، get یا patch . میتوانید یک CourseWork StudentSubmission reclaim ، return یا turnIn .
ورود یکپارچه
آیا دانشآموزانی که از نشانهای Clever یا Classlink برای ورود به Chromebook خود استفاده میکنند، میتوانند از ورود به سیستم Google نیز استفاده کنند؟
بله، آنها هنوز هم میتوانند از ورود به سیستم گوگل استفاده کنند.
آیا هر دانشآموزی حتی اگر به جیمیل دسترسی نداشته باشد، یک آدرس ایمیل صحیح دارد؟
هر کاربر Google Workspace for Education صرف نظر از اینکه به Gmail دسترسی داشته باشد یا خیر، یک هویت گوگل دارد. هویت و دسترسی به هر سرویس خاص گوگل (از جمله Gmail) متمایز است. حتی اگر Gmail غیرفعال باشد، کاربران دانشآموز میتوانند با آدرس ایمیل خود وارد Classroom شوند. هویتها توسط یک شناسه کاربری و یک آدرس ایمیل نمایش داده میشوند. یک کاربر Google Workspace for Education میتواند آدرس ایمیل خود را تغییر دهد، بنابراین توصیه میشود هنگام ذخیره اطلاعات کاربر از شناسههای کاربری به عنوان کلیدهای اصلی استفاده کنید.
آیا مدیر مدرسه برای اجازه ورود دانشآموزان به برنامه، نیاز به تأیید قبلی دارد؟
مدیران دامنه باید قبل از نصب افزونه، آن را در فهرست مجاز قرار دهند . به صورت اختیاری، مدیران دامنه میتوانند افزونهای را برای همه کاربران درون دامنه یا یک واحد سازمانی نصب کنند.
بازخورد و سوالات عمومی
چگونه میتوانم درخواستهای مربوط به ویژگیها یا درخواست مشکلات را ارسال کنم؟
شما میتوانید درخواستهای مربوط به ویژگیهای جدید را در ردیاب مشکلات عمومی ما ارسال، مشاهده و رأی دهید.
چطور میتوانم از اضافه شدن ویژگیهای جدید به Classroom API مطلع شوم؟
بهروزرسانیهای API در خبرنامه توسعهدهندگان و ردیاب مشکلات عمومی منتشر میشوند.
من از رابط برنامهنویسی کاربردی کلاس درس استفاده میکنم. چگونه میتوانم سوالات فنی بپرسم؟
سوالات خود را با تگ google-classroom در Stack Overflow ارسال کنید.