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