این سند حاوی اطلاعات مربوط به مجوز و احراز هویت مختص API کلاس درس گوگل است. قبل از مطالعه این سند، حتماً اطلاعات عمومی احراز هویت و مجوز Google Workspace را در بخش «درباره احراز هویت و مجوز بیشتر بدانید» مطالعه کنید.
پیکربندی OAuth 2.0 برای احراز هویت
صفحه رضایت OAuth را پیکربندی کنید و محدودههایی را برای تعریف اطلاعات نمایش داده شده به کاربران و بررسیکنندگان برنامه انتخاب کنید و برنامه خود را ثبت کنید تا بتوانید بعداً آن را منتشر کنید.
دامنههای API کلاس درس
برای تعریف سطح دسترسی اعطا شده به برنامه خود، باید حوزههای مجوز را شناسایی و اعلام کنید. حوزه مجوز، یک رشته URI از نوع OAuth 2.0 است که شامل نام برنامه Google Workspace، نوع دادههایی که به آنها دسترسی دارد و سطح دسترسی است. حوزهها، درخواستهای برنامه شما برای کار با دادههای Google Workspace، از جمله دادههای حساب Google کاربران، هستند.
وقتی برنامه شما نصب میشود، از کاربر خواسته میشود تا محدودههای مورد استفاده برنامه را اعتبارسنجی کند. به طور کلی، شما باید محدودهای را انتخاب کنید که بیشترین تمرکز را داشته باشد و از درخواست محدودههایی که برنامه شما به آنها نیاز ندارد، خودداری کنید. کاربران راحتتر به محدودههای محدود و واضح دسترسی میدهند.
API کلاس درس از حوزههای زیر پشتیبانی میکند:
| محدودهها | معنی |
|---|---|
https://www.googleapis.com/auth/classroom.addons.teacher | پیوستهای درخواستی پروژه Google Cloud را مشاهده، ایجاد و بهروزرسانی کنید تا موارد را در کلاسهایی که در Google Classroom تدریس میکنید، پخش کنید. |
https://www.googleapis.com/auth/classroom.addons.student | پیوستهای درخواستی پروژه Google Cloud را برای پخش موارد در Google Classroom مشاهده و بهروزرسانی کنید. |
https://www.googleapis.com/auth/classroom.announcements | مشاهده و مدیریت اعلانها در گوگل کلاسروم |
https://www.googleapis.com/auth/classroom.announcements.readonly | اعلانها را در Google Classroom مشاهده کنید. |
https://www.googleapis.com/auth/classroom.courses | کلاسهای Google Classroom خود را ببینید، ویرایش کنید، ایجاد کنید و برای همیشه حذف کنید. |
https://www.googleapis.com/auth/classroom.courses.readonly | کلاسهای گوگل کلاسروم خود را مشاهده کنید. |
https://www.googleapis.com/auth/classroom.coursework.me | موارد مربوط به دورههای آموزشی از جمله تکالیف، سوالات و نمرات را مشاهده، ایجاد و ویرایش کنید. |
https://www.googleapis.com/auth/classroom.coursework.me.readonly | دروس و نمرات خود را در Google Classroom مشاهده کنید. |
https://www.googleapis.com/auth/classroom.coursework.students | تکالیف و نمرات دانشآموزان را در کلاسهای Google Classroom که تدریس میکنید مدیریت کنید و تکالیف و نمرات کلاسهایی را که اداره میکنید مشاهده کنید. |
https://www.googleapis.com/auth/classroom.coursework.students.readonly | مشاهدهی تکالیف و نمرات دانشآموزان در کلاسهای Google Classroom که تدریس یا مدیریت میکنید. |
https://www.googleapis.com/auth/classroom.courseworkmaterials | مطالب کلاسی را در Google Classroom ببینید، ویرایش کنید و ایجاد کنید. |
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly | تمام مطالب کلاسی مربوط به کلاسهای Google Classroom خود را ببینید. |
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly | سرپرستان کلاس درس گوگل خود را مشاهده کنید. |
https://www.googleapis.com/auth/classroom.guardianlinks.students | مشاهده و مدیریت سرپرستان دانشآموزان در کلاسهای Google Classroom شما. |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly | سرپرستان دانشآموزان را در کلاسهای Google Classroom خود مشاهده کنید. |
https://www.googleapis.com/auth/classroom.profile.emails | آدرسهای ایمیل افراد حاضر در کلاسهایتان را مشاهده کنید. |
https://www.googleapis.com/auth/classroom.profile.photos | عکسهای پروفایل افراد در کلاسهایتان را مشاهده کنید. |
https://www.googleapis.com/auth/classroom.push-notifications | درباره دادههای Google Classroom خود اعلان دریافت کنید. |
https://www.googleapis.com/auth/classroom.rosters | فهرست کلاسهای گوگل کلاسروم خود را مدیریت کنید. |
https://www.googleapis.com/auth/classroom.rosters.readonly | فهرست کلاسهای گوگل کلاسروم خود را مشاهده کنید. |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly | دروس و نمرات خود را در Google Classroom مشاهده کنید. |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly | مشاهدهی تکالیف و نمرات دانشآموزان در کلاسهای Google Classroom که تدریس یا مدیریت میکنید. |
https://www.googleapis.com/auth/classroom.topics | مشاهده، ایجاد و ویرایش موضوعات در Google Classroom. |
https://www.googleapis.com/auth/classroom.topics.readonly | مشاهده مباحث در گوگل کلاس روم. |