يتضمّن هذا المستند معلومات التفويض والمصادقة الخاصة بـ Google Classroom API. قبل قراءة هذا المستند، احرص على قراءة معلومات المصادقة والتفويض العامة في Google Workspace على الرابط التعرّف على المصادقة والتفويض.
ضبط OAuth 2.0 للتفويض
ضبط شاشة موافقة بروتوكول OAuth واختيار النطاقات لتحديد المعلومات التي يتم عرضها للمستخدمين ومعلّقي التطبيقات، وتسجيل تطبيقك حتى تتمكّن من نشره لاحقًا
نطاقات Classroom API
لتحديد مستوى الوصول الممنوح لتطبيقك، عليك تحديد نطاقات التفويض و الإفصاح عنها. نطاق التفويض هو سلسلة عنوان موارد متحدّد (URI) في 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 |