سفر توسعه دهنده

در زیر مروری سریع بر مراحل ایجاد یک افزونه Classroom ارائه شده است.

مهم: برای دریافت به‌روزرسانی‌ها درباره افزونه‌ها و Google Classroom API در گروه اعلامیه برنامه‌نویس Google for Education مشترک شوید.

سوار شدن

1. به کاربران آزمایشی با نسخه‌های Teaching & Learning یا Plus Google Workspace for Education نیاز دارید. اگر با هر یک از این مجوزها به دامنه Google Workspace for Education دسترسی سرپرست ندارید، مراحل دریافت یک دامنه آزمایشی توسعه‌دهنده را تکمیل کنید و سپس فرم درخواست ارتقاء دامنه ما را ارسال کنید. دامنه دارای 10 مجوز Google Workspace for Education Plus خواهد بود.

2. یک پروژه Google Cloud ایجاد کنید . شما از آن برای پیکربندی افزونه خود، درخواست های API و احراز هویت و مجوز دادن به کاربران استفاده خواهید کرد. همچنین می توانید از یک پروژه Cloud موجود استفاده کنید.

   هشدار: به نمایان بودن برنامه توجه ویژه ای داشته باشید. این تنظیم کنترل می‌کند که آیا افزونه شما برای کاربران نهایی قابل دسترسی باشد و بعداً قابل تغییر نباشد .

3. ایجاد حساب معلم و دانش آموز برای تست. هنگامی که مجوز برای دامنه آزمایشی شما تأیید شد، به هر یک از حساب های آزمایشی خود صندلی اختصاص دهید .

4. OAuth را برای پروژه خود پیکربندی کنید .

5. یک لیست Google Workspace Marketplace برای پروژه نمایشی ایجاد کنید .

   • اگر نمایان بودن برنامه را روی عمومی تنظیم کرده اید، آدرس ایمیل همه کاربران آزمایشی را به لیست آزمایش کنندگان پیش نویس اضافه کنید. پس از اتمام، SAVE DRAFT را انتخاب کنید.
   نکته کلیدی: یک پروژه در حالت پیش نویس به شما امکان می دهد تغییرات را قبل از انتشار پیش نمایش و آزمایش کنید. برای اطلاعات بیشتر درباره این ویژگی، به به‌روزرسانی فهرست برنامه با پیش‌نویس‌ها مراجعه کنید.

6. به عنوان کاربر آزمایشی وارد دامنه آزمایشی خود شوید. افزونه خود را از URL برنامه در پیکربندی فهرست Google Workspace Marketplace خود نصب کنید.

توسعه

7. افزونه را توسعه دهید و آن را با کاربران آزمایشی خود آزمایش کنید.

انتشار

8. در پروژه Google Cloud که می‌خواهید منتشر کنید ، از موارد زیر اطمینان حاصل کنید:
   1. صفحه رضایت OAuth:
      1. نوع کاربر: خارجی
      2. وضعیت انتشار: در حال تولید
      3. Scopes: تمام محدوده های درخواست شده توسط برنامه وب را پیکربندی کنید .
   2. صفحه پیکربندی برنامه Google Workspace Marketplace SDK:
      1. قابلیت مشاهده برنامه: عمومی
      2. نوع فهرست: فهرست نشده
      3. Scopes: تمام محدوده های درخواست شده توسط برنامه وب را پیکربندی کنید .
9. یک فهرست Google Workspace Marketplace برای پروژه عمومی ایجاد کنید . حساب های کاربری آزمایشی خود را به عنوان آزمایش کنندگان پیش نویس SDK Marketplace اضافه کنید. تغییرات خود را به عنوان پیش نویس ذخیره کنید.
10. پروژه عمومی را با کد افزودنی خود به روز کنید.
11. به‌عنوان یکی از آزمایش‌کنندگان پیش‌نویس، افزونه را با مراجعه به URL فهرست‌بندی بازار آن نصب کنید.
12. یک درخواست تأیید OAuth برای پروژه عمومی خود ارسال کنید. باید با استفاده از یکی از حساب‌های آزمایش‌کننده پیش‌نویس، ویدیوی کوتاهی ضبط کنید که نشان‌دهنده استفاده از دامنه‌های افزودنی است.
13. افزونه عمومی را برای بررسی Marketplace منتشر کنید .
14. پس از تأیید، وضعیت فهرست SDK Marketplace را به فهرست شده تغییر دهید.

ادغام های مورد نیاز

برای ساختن افزونه Classroom موارد زیر لازم است.

1. Google Single Sign-On

   • پلتفرم هویت گوگل گوگل گزینه های مختلف احراز هویت را ارائه می دهد.
   • مطالعات موردی ادغام

   برای اطلاعات در مورد نحوه اجرای ورود به سیستم با رعایت بهترین شیوه ها، صفحه ورود بدون اصطکاک را ببینید.

2. ارائه به Google Workspace Marketplace به‌عنوان یک افزونه Classroom

3. پیاده سازی های iframe

   • کشف پیوست
   • نمای معلم
   • نمای دانشجویی
   • بررسی کار دانشجویی iframe Student Work Review فقط در صورتی لازم است که پیوست یک پیوست از نوع فعالیت ارائه دهد.

Google Workspace Marketplace

Google Workspace Marketplace برنامه‌های کاربردی سازمانی را به نمایش می‌گذارد که می‌توانند به کل دامنه یا حساب‌های Google Workspace اضافه شوند. Marketplace با کنسول Google Admin ادغام شده است تا مدیران دامنه بتوانند به سرعت برنامه ها را برای کاربران هدف پیدا کرده، نصب کنند و مجوز دهند.

برخی از مفاهیم کلیدی که باید با آنها آشنا شد عبارتند از:

• رفتار و الزامات OAuth .
• اسناد توسعه دهنده Google Workspace Marketplace .
• بخش آموزش Google Workspace Marketplace.