בחירת היקפים של Google Classroom API

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