يتضمّن هذا المستند معلومات حول المصادقة والتفويض الخاصة بواجهة 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 |