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

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

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

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

  • مشاهده تکالیف و سوالات (که در مجموع به عنوان CourseWork نامیده می شود) برای یک کاربر
  • 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 می تواند دو لیست 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 وجود دارد؟

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

دامنه ها

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

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

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

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

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

API

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

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

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

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

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

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

Single Sign-On

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

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

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

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

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

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

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

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

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

به‌روزرسانی‌های API در صفحه یادداشت‌های انتشار ، انجمن توسعه‌دهندگان ما و ردیاب مسائل عمومی پست می‌شوند.

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

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