نظرا لأن Microsoft تعزز وضعها الأمني عبر جميع المنتجات والخدمات، فقد حدثت تغييرات حديثة على وظائف واجهة برمجة التطبيقات قد تؤثر على العملاء الذين كانوا يعتمدون مسبقا على أذونات التطبيق فقط لتوفير دفاتر ملاحظات للصفوف باستخدام واجهات برمجة التطبيقات.
لا يزال بإمكانك توفير المواقع ودفاتر الملاحظات على نطاق واسع باستخدام واجهات برمجة تطبيقات Microsoft Graph باتباع أسلوب بديل مدعوم. توضح هذه المقالة الخطوات وتوفر ارتباطات إلى الوثائق ذات الصلة.
نظرة عامة
لمتابعة توفير دفاتر ملاحظات للصفوف ومواقع SharePoint على نطاق واسع:
- استخدم واجهة برمجة تطبيقات CreateEducationClass عند إنشاء مواقع جديدة (مجموعة/موقع واحد لكل فئة)
- بالنسبة للمواقع الموجودة مسبقا، استخدم واجهة برمجة تطبيقات SharePoint CreatePermission لمنح دفتر ملاحظات للصفوف من OneNote AppId permisisons إلى هذا الموقع.
- بمجرد اكتمال الخطوات المذكورة أعلاه، يجب استعادة وظيفة دفتر ملاحظات للصفوف الموجودة ويجب أن تعمل استدعاءات واجهة برمجة التطبيقات مثل GetClassNotebooksوAddTeacherوadstudent كما هو متوقع.
إرشادات خطوة بخطوة
1. إنشاء مواقع جديدة باستخدام CreateEducationClass
استخدم واجهة برمجة تطبيقات CreateEducationClass لإنشاء مجموعة Microsoft 365 جديدة وموقع SharePoint مقترن لكل فئة.
- توفر واجهة برمجة التطبيقات هذه المجموعة والموقع والموارد المقترنة في مكالمة واحدة.
- بعد إنشاء الموقع، يمكنك استخدام واجهات برمجة التطبيقات الموجودة لإدارة دفاتر الملاحظات والأذونات.
المرجع: وثائق واجهة برمجة تطبيقات CreateEducationClass
2. منح أذونات للمواقع الموجودة
بالنسبة للمجموعات أو المواقع الموجودة، يجب منح تطبيق دفتر ملاحظات للصفوف حق الوصول صراحة باستخدام نموذج الأذونات 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 } }] } |
|---|
مراجع:
إنشاء واجهة برمجة تطبيقات الأذونات
تطوير التطبيقات التي تستخدم المواقع.الأذونات المحددة لمواقع SPO
3. استخدام واجهات برمجة التطبيقات الموجودة لإدارة دفتر الملاحظات
بمجرد تكوين الأذونات بشكل صحيح، يجب أن تستمر وظيفة دفتر ملاحظات للصفوف الموجودة مثل واجهات برمجة التطبيقات التالية في العمل كما كان من قبل:
GetClassNotebooks
AddTeacher
إضافة مسافة
إنشاءClassNotebook
- ملاحظة: كما هو موضح أعلاه، بالنسبة للمجموعات/المواقع الجديدة، استخدم CreateEducationClass بدلا من ذلك