ככל ש- Microsoft משפרת את מצב האבטחה שלה בכל המוצרים והשירותים, חלו לאחרונה שינויים בפונקציונליות של API שעשויים להשפיע על לקוחות שבעבר הסתמכו על הרשאות של אפליקציה בלבד כדי להקצות מחברות כיתה באמצעות ממשקי API.
עדיין ניתן להקצות אתרים ומחברות בקנה מידה נרחב באמצעות ממשקי API של Microsoft Graph על-ידי שימוש בשיטה חלופית נתמכת. מאמר זה מפרט את השלבים ומספק קישורים לתיעוד רלוונטי.
סקירה כללית
כדי להמשיך להקצות מחברות כיתה ואתרי SharePoint בקנה מידה גדול:
- שימוש ב - API של CreateEducationClass בעת יצירת אתרים חדשים (קבוצה/אתר אחד לכל כיתה)
- עבור אתרים קיימים מראש, השתמש ב - API של SharePoint CreatePermission כדי להעניק למחברת כיתה של OneNote הרשאות AppId לאתר זה.
- לאחר השלמת השלבים שלעיל, יש לשחזר את הפונקציונליות הקיימת של מחברת הכיתה ולפעול כצפוי קריאות API, כגון GetClassNotebooks, AddTeacher ו - addStudent .
הוראות שלב אחר שלב
1. צור אתרים חדשים עם CreateEducationClass
השתמש ב- API של CreateEducationClass כדי ליצור קבוצת Microsoft 365 חדשה ואתר SharePoint משויך עבור כל כיתה.
- API זה מקצה את הקבוצה, האתר והמשאבים המשויכים בקריאה אחת.
- לאחר יצירת האתר, תוכל להשתמש בממשקי API קיימים כדי לנהל מחברות והרשאות.
חומר עזר: תיעוד API של CreateEducationClass
2. הענקת הרשאות לאתרים קיימים
עבור קבוצות או אתרים קיימים, עליך להעניק גישה ליישום 'מחברת כיתה' באופן מפורש באמצעות מודל ההרשאה Sites.Selected .
הרשאות נדרשות
- גישה ליישומים בלבד באמצעות הטווח Sites.Selected.
- הענק לאפליקציה EDU OneNote שליטה מלאה באתר.
בקשה לדוגמה
| POST https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions Content-Type: application/json { "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "13291f5a-59ac-4c59-b0fa-d1632e8f3292", //target application's client id "displayName": "EDU OneNote" //target application's display name } }] } |
|---|
הפניות:
פיתוח יישומים המשתמשים בהרשאות Sites.Selected עבור אתרי SPO
3. שימוש בממשקי API קיימים לניהול מחברות
לאחר שתצורת ההרשאות נקבעה כהלכה, הפונקציונליות הקיימת של מחברת הכיתה, כגון ממשקי ה- API הבאים, אמורה להמשיך לפעול כמו בעבר:
GetClassNotebooks
AddTeacher
AddStudent
CreateClassNotebook
- הערה: כמתואר לעיל, עבור קבוצות/אתרים חדשים, השתמש במקום זאת ב- CreateEducationClass