سوالات متداول

مشاهده، ایجاد و اصلاح CourseWork در Classroom

چه چیزی می توانم با نقاط پایانی CourseWork در Classroom API بسازم؟

نقاط پایانی به توسعه‌دهندگان اجازه می‌دهند کار را در یک کلاس مشاهده و مدیریت کنند. به طور خاص، شما می توانید تمام موارد زیر را انجام دهید:

• مشاهده تکالیف و سوالات (که در مجموع به عنوان CourseWork نامیده می شود) برای یک کاربر.
• CourseWork ایجاد، اصلاح و حذف کنید.
• مواد (فایل‌های Drive، ویدیوهای YouTube، پیوندها) را به CourseWork پیوست کنید.
• وضعیت ارسال دانش آموز را تغییر دهید (مانند تحویل، بازگشت، بازپس گیری).
• نمره را برای ارسال تکلیف تعیین کنید.
• مطالب (فایل‌های Drive، ویدیوهای YouTube، پیوندها) را به مطالب ارسالی دانش‌آموز پیوست کنید.

چند نمونه از موارد استفاده برای CourseWork :

• کتاب‌های نمره، SIS یا سیستم‌های گزارش‌دهی می‌توانند تکالیف و نمرات را از Classroom با برنامه‌های خود همگام‌سازی کنند و انتقال دستی داده‌ها را حذف کنند.
• برنامه های آموزشی می توانند تکالیف جدیدی ایجاد کنند که در جریان کلاس ظاهر می شوند. وقتی دانش‌آموزان کار را کامل می‌کنند، برنامه‌ها می‌توانند کار را تحویل دهند، نمره‌ها را تعیین کنند، کار دانش‌آموز را پیوست کنند، و کار را در پوشه‌های Drive مناسب ذخیره کنند.
• کاربران معلم می توانند تکالیفی را با پیوست های افزودنی از وب سایت یا برنامه شما ایجاد کنند.
• کاربران دانش‌آموز می‌توانند تکالیف خود را که دارای پیوست‌های افزودنی شما هستند، تحویل دهند.

برنامه من برای ایجاد یا تغییر تکالیف به چه مجوزهایی نیاز دارد؟

به طور معمول، یک برنامه فقط می تواند کاری را که ایجاد می کند تغییر دهد. به عبارت دیگر، هر درخواست API برای تغییر CourseWork باید از همان شناسه پروژه Google Cloud استفاده کند که برای ایجاد CourseWork استفاده شده است.

افزونه های 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 می تواند دو لیست Google Workspace Marketplace داشته باشد؟

خیر. نمی‌توانید دو فهرست Google Workspace Marketplace برای یک پروژه Google Cloud ایجاد کنید.

با این حال، امکان بسته‌بندی افزونه‌ها وجود دارد. انجام این کار به یک لیست Google Workspace Marketplace اجازه می دهد تا چندین افزونه را نشان دهد. نصب از چنین فهرستی تمام افزونه های موجود در بسته را به یکباره نصب می کند. هنگام صدور مجوز، کاربران باید با همه حوزه‌های مورد نیاز افزونه‌های همراه موافقت کنند.

آیا می توان از یک سرویس گیرنده OAuth از پروژه Google Cloud دیگری با پروژه Google Cloud برای افزونه های Classroom استفاده مجدد کرد؟

خیر، یک سرویس گیرنده OAuth از پروژه Google Cloud غیر از پروژه Google Cloud برافزای Classroom نمی‌تواند کار کند. توکن‌های دسترسی تولید شده توسط پروژه Google Cloud دیگر توسط API Classroom رد می‌شوند. شما باید یک سرویس گیرنده OAuth جداگانه برای پروژه الحاقی ایجاد کنید.

تجربه کاربری

نشان‌واره ما به خوبی در یک مربع کوچک قرار نمی‌گیرد، چه گزینه‌هایی برای نشان‌واره‌ها در نوار عنوان iframe افزونه‌های Classroom وجود دارد؟

نوار عنوان iframe فقط برای پشتیبانی از لوگوی مربعی 32x32 طراحی شده است. این انتخاب برای مطابقت با شکل فاویکون که شرکت‌ها در وب‌سایت‌های خود استفاده می‌کنند انجام شده است و راهنمایی ما برای استفاده از همان لوگو در فضا برای ثبات برند است.

دامنه ها

آیا همه معلمان و دانش آموزان در یک دامنه به یک افزونه نصب شده دسترسی دارند؟

مدیران دامنه می توانند کنترل کنند که کدام معلمان می توانند افزونه نصب شده را ببینند. افزونه‌های کلاسرو فقط برای کاربران دارای مجوز Teaching & Learning یا Education Plus قابل استفاده است.

مدیران دامنه چگونه با افزونه ها تعامل دارند؟

مدیران دامنه کنترل می کنند که چه کسانی می توانند از افزونه شما استفاده کنند. آنها می توانند با استفاده از گزینه نصب مدیر، یک افزونه برای کل دامنه نصب کنند. اگر می توان افزونه شما را به صورت جداگانه نصب کرد، توجه داشته باشید که اکثر مدیران یک لیست مجاز افزودنی دارند. معلمانی که در این لیست هستند می توانند افزونه هایی را برای خود نصب کنند. یک سرپرست همچنین ممکن است تصمیم بگیرد که افزونه شما را به صورت جداگانه برای اهداف آزمایش نصب کند.

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

API

راه مطمئنی برای دانستن اینکه آیا محتوای افزونه در داخل یک iframe یا یک تب جدید بارگذاری شده است چیست؟

هیچ روش فعلی برای تمایز بین این دو وجود ندارد.

کدام موارد کاری قابل تخصیص iframe بررسی کار دانشجویی می‌شود؟

iframe Student Work Review فقط برای پیوست‌های نوع فعالیت ارائه شده است. با متد courses.courseWork.getAddOnContext تماس بگیرید تا مشخص شود آیا نوع پست از کار دانشجو پشتیبانی می کند یا خیر. فیلد supportsStudentWork فقط برای یک نوع پست که یک فعالیت است می تواند true باشد.

آیا یک پیوست افزودنی می تواند به آیتم جریانی که به آن پیوست شده است دسترسی داشته باشد؟

بله. می‌توانید هر Announcement ، CourseWork ، یا CourseWorkMaterial را که حداقل یکی از پیوست‌های افزودنی شما را شامل می‌شود، get یا patch . شما می توانید reclaim ، return یا turnIn یک CourseWork StudentSubmission ارسال کنید.

Single Sign-On

آیا دانش‌آموزانی که از نشان‌های هوشمند یا Classlink برای ورود به Chromebook خود استفاده می‌کنند، می‌توانند از ورود به سیستم Google استفاده کنند؟

بله، آنها همچنان می توانند از Google Sign-In استفاده کنند.

آیا هر دانش آموزی حتی اگر به جیمیل دسترسی نداشته باشد، آدرس ایمیل درستی دارد؟

هر کاربر Google Workspace for Education بدون در نظر گرفتن اینکه آیا به Gmail دسترسی دارد یا خیر، یک هویت Google دارد. هویت و دسترسی به هر سرویس خاص Google (از جمله Gmail) متمایز است. حتی اگر Gmail غیرفعال باشد، کاربران دانشجو می توانند با آدرس ایمیل خود وارد Classroom شوند. هویت ها با شناسه کاربری و آدرس ایمیل نشان داده می شوند. کاربر Google Workspace for Education می‌تواند آدرس ایمیل خود را تغییر دهد، بنابراین توصیه می‌شود هنگام ذخیره اطلاعات کاربر از شناسه‌های کاربر به عنوان کلیدهای اصلی استفاده کنید.

آیا مدیر مدرسه باید برنامه را از قبل تأیید کند تا به دانش آموزان اجازه ورود به سیستم بدهد؟

مدیران دامنه باید یک افزونه را قبل از نصب آن لیست کنند . به صورت اختیاری، مدیران دامنه می توانند افزونه ای را برای همه کاربران داخل دامنه یا یک واحد سازمانی نصب کنند.

بازخورد و سوالات عمومی

چگونه می توانم درخواست های ویژگی یا درخواست مشکلات را ارسال کنم؟

می‌توانید درخواست‌های ویژگی را در ردیاب مسائل عمومی ما ارسال کنید، مشاهده کنید، و به آنها رأی دهید.

چگونه می توانم بدانم که ویژگی های جدید در Classroom API موجود است؟

به‌روزرسانی‌های API در خبرنامه برنامه‌نویس و ردیاب مسائل عمومی پست می‌شوند.

من از Classroom API استفاده می کنم. چگونه می توانم سوالات فنی بپرسم؟

سوالات خود را با برچسب google-classroom در Stack Overflow ارسال کنید.