نظرا لأن Microsoft تعمل على تحسين وضع الأمان في جميع المنتجات والخدمات، فقد طرأت تغييرات حديثة على وظائف واجهة برمجة التطبيقات التي قد تؤثر على العملاء الذين كانوا يعتمدون سابقا على أذونات التطبيق فقط لتوفير دفاتر ملاحظات للصفوف باستخدام واجهات برمجة التطبيقات.
ما زال بإمكانك توفير المواقع ودفاتر الملاحظات على نطاق واسع باستخدام واجهات برمجة تطبيقات Microsoft Graph باتباع طريقة بديلة معتمدة. توضح هذه المقالة الخطوات وتوفر ارتباطات إلى الوثائق ذات الصلة.
نظرة عامة
لمتابعة تزويد دفاتر ملاحظات الصفوف ومواقع SharePoint على نطاق واسع:
- استخدام CreateEducationClass API عند إنشاء مواقع جديدة (مجموعة/موقع واحد لكل فئة)
- بالنسبة للمواقع الموجودة مسبقا، استخدم واجهة برمجة تطبيقات CreatePermission ل SharePoint لمنح أذونات AppNotebook للصفوف في OneNote أذونات لهذا الموقع.
- بعد اكتمال الخطوات المذكورة أعلاه، يجب استعادة وظائف دفتر ملاحظات للصفوف الموجودة ويجب أن تعمل استدعاءات API مثل GetClassNotebooksوAddTeacherوaddStudent كما هو متوقع.
إرشادات مفصلة خطوة بخطوة
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", //معرف عميل التطبيق الهدف "displayName": "EDU OneNote" //اسم العرض للتطبيق الهدف } }] } |
|---|
المراجع:
تطوير التطبيقات التي تستخدم أذونات Sites.Selected لمواقع SPO
3. استخدام واجهات برمجة التطبيقات الحالية لإدارة دفتر الملاحظات
بمجرد تكوين الأذونات بشكل صحيح، من المفترض أن تستمر وظائف دفتر ملاحظات للصفوف الموجودة مثل واجهات برمجة التطبيقات التالية في العمل كما كان من قبل:
GetClassNotebooks
AddTeacher
إضافة طالب
CreateClassNotebook
- ملاحظة: كما هو موضح أعلاه، بالنسبة إلى المجموعات/المواقع الجديدة، استخدم CreateEducationClass بدلا من ذلك