Microsoft tüm ürün ve hizmetlerde güvenlik duruşunu geliştirirken, API işlevselliğinde daha önce API'leri kullanarak Sınıf Not Defterleri sağlamak için yalnızca uygulama izinlerine güvenen müşterileri etkileyebilecek değişiklikler yapılmıştır.
Desteklenen alternatif bir yöntem izleyerek, Microsoft Graph API'lerini kullanarak siteleri ve not defterlerini ölçeğe uygun ölçekte sağlamaya devam edebilirsiniz. Bu makalede adımlar özetlenir ve ilgili belgelerin bağlantıları sağlanır.
Genel bakış
Sınıf Not Defterlerini ve SharePoint sitelerini büyük ölçekte sağlamaya devam etmek için:
- Yeni siteler oluştururken CreateEducationClass API'sini kullanma (sınıf başına bir grup/site)
- Önceden var olan sitelerde, bu siteye OneNote Sınıf Not Defteri AppId izinleri vermek için SharePoint CreatePermission API'sini kullanın.
- Yukarıdaki adımlar tamamlandıktan sonra var olan Sınıf Not Defteri işlevselliği geri yüklenmeli ve GetClassNotebooks, AddTeacher ve addStudent gibi API çağrıları beklendiği gibi çalışmalıdır.
Adım adım yönergeler
1. CreateEducationClass ile Yeni Siteler Oluşturun
Her sınıf için yeni bir Microsoft 365 Grubu ve ilişkili SharePoint sitesi oluşturmak için CreateEducationClass API'sini kullanın.
- Bu API, Grubu, Siteyi ve ilişkili kaynakları tek bir çağrıda sağlar.
- Site oluşturulduktan sonra, not defterlerini ve izinleri yönetmek için mevcut API'leri kullanabilirsiniz.
Başvuru: CreateEducationClass API belgeleri
2. Var olan sitelere izinler atama
Mevcut Gruplar veya Siteler için, Sites.Selected izin modelini kullanarak Sınıf Not Defteri uygulamasına erişimi açıkça vermeniz gerekir.
Gerekli İzinler
- Sites.Selected kapsamını kullanarak yalnızca uygulama erişimi.
- EDU OneNote uygulamasına siteye tam denetim atayın.
Örnek İstek
| 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 uygulamanın istemci kimliği "displayName": "EDU OneNote" //target uygulamanın görünen adı } }] } |
|---|
Referanslar:
SPO siteleri için Siteler.Seçili izinleri kullanan Uygulamalar geliştirme
3. Not Defteri Yönetimi için Mevcut API'leri Kullanma
İzinler doğru bir şekilde yapılandırıldıktan sonra, aşağıdaki API'ler gibi var olan Sınıf Not Defteri işlevselliği eskisi gibi çalışmaya devam etmelidir:
GetClassNotebooks
Öğretmen Ekle
AddStudent'ı seçin
SınıfNot Defteri Oluştur
- Not: Yukarıda açıklandığı gibi, yeni Gruplar/Siteler için bunun yerine CreateEducationClass kullanın.