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