במסמך הזה מפורט מידע ספציפי לגבי הרשאות ואימות של Google Classroom API. לפני קריאת המסמך הזה, חשוב לקרוא את המידע הכללי על אימות והרשאה ב-Google Workspace במאמר מידע על אימות והרשאה.
הגדרת OAuth 2.0 להרשאה
מגדירים את מסך ההסכמה של OAuth ובוחרים היקפי הרשאה כדי לקבוע איזה מידע יוצג למשתמשים ולבודקים של האפליקציה, ומרשמים את האפליקציה כדי שתוכלו לפרסם אותה בהמשך.
היקפי הרשאה של Classroom API
כדי להגדיר את רמת הגישה שמוענקת לאפליקציה, צריך לזהות ולצהיר על היקפי הרשאה. היקף הרשאה הוא מחרוזת URI של OAuth 2.0 שמכילה את שם האפליקציה ב-Google Workspace, את סוג הנתונים שהיא ניגשת אליהם ואת רמת הגישה. היקפים הם הבקשות של האפליקציה לעבוד עם נתוני Google Workspace, כולל נתונים מחשבון Google של המשתמשים.
כשהאפליקציה מותקנת, המשתמש מתבקש לאמת את ההיקפים שבהם האפליקציה משתמשת. באופן כללי, כדאי לבחור את ההיקף המצומצם ביותר האפשרי ולהימנע מבקשות להיקפים שלא נדרשים לאפליקציה. משתמשים נותנים גישה בקלות רבה יותר להיקפים מוגבלים ומתוארים בבירור.
ה-API של Classroom תומך בהיקפים הבאים:
| טווחים | משמעות |
|---|---|
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. |