במסמך הזה תמצאו מידע על אימות והרשאות שספציפיים ל-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 |