يتضمّن هذا المستند معلومات التفويض والمصادقة الخاصة بـ Google Classroom API. قبل قراءة هذا المستند، احرص على قراءة معلومات المصادقة والتفويض العامة في Google Workspace على الرابط التعرّف على المصادقة والتفويض.
ضبط بروتوكول OAuth 2.0 للتفويض
ضبط شاشة موافقة بروتوكول OAuth واختيار النطاقات لتحديد المعلومات التي يتم عرضها للمستخدمين ومعلّقي التطبيقات، وتسجيل تطبيقك حتى تتمكّن من نشره لاحقًا
نطاقات Classroom API
لتحديد مستوى الوصول الممنوح لتطبيقك، عليك تحديد نطاقات التفويض و الإفصاح عنها. نطاق التفويض هو سلسلة عنوان URL لبروتوكول OAuth 2.0 تحتوي على اسم تطبيق Google Workspace ونوع البيانات التي يصل إليها ومستوى الوصول. النطاقات هي طلبات تطبيقك للعمل باستخدام بيانات Google Workspace، بما في ذلك بيانات حسابات المستخدمين على Google.
عند تثبيت تطبيقك، يُطلب من المستخدم التحقّق من صحة النطاقات التي يستخدمها التطبيق. بشكل عام، يجب اختيار النطاق الذي يركز على أصغر عدد ممكن من الأذونات وتجنُّب طلب النطاقات التي لا يتطلبها تطبيقك. يمنح المستخدمون الإذن بالوصول إلى نطاقات محدودة وموضّحة بوضوح بشكلٍ أسهل.
تتيح Classroom 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
|
عرض الإعلانات وإدارتها في Google Classroom |
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
|
يمكنك عرض صفوفك في Google Classroom. |
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
|
عرض أوصياء Google Classroom |
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
|
إدارة قوائم الطلاب المسجّلين في صفوفك على Google Classroom |
https://www.googleapis.com/auth/classroom.rosters.readonly
|
عرض قوائم دروسك في Google Classroom |
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
|
عرض المواضيع في Google Classroom |