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

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