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