Microsoft Graph API'lerini Kullanarak Sınıf Not Defterlerini ve Siteleri Uygun Ölçekte Sağlama

Microsoft tüm ürün ve hizmetler genelinde güvenlik duruşunu geliştirdikçe, 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 son değişiklikler yapılmıştır.

Desteklenen alternatif bir yöntemi izleyerek Microsoft Graph API'lerini kullanarak siteleri ve not defterlerini uygun ölçekte sağlamaya devam edebilirsiniz. Bu makalede adımlar özetlenmiştir ve ilgili belgelere bağlantılar sağlanmaktadır.

Genel Bakış

Sınıf Not Defterlerini ve SharePoint sitelerini uygun ölçekte sağlamaya devam etmek için:

  1. Yeni siteler oluştururken CreateEducationClass API'sini kullanın (sınıf başına bir grup/site)
  2. Önceden var olan siteler için SharePoint CreatePermission API'sini kullanarak bu siteye OneNote Sınıf Not Defteri AppId kimlikleri verin.
  3. Yukarıdaki adımlar tamamlandıktan sonra, mevcut Sınıf Not Defteri işlevselliği geri yüklenmelidir 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şturma

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 Grup, Site 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. Mevcut Sitelere İzin Verme

Mevcut Gruplar veya Siteler için, Siteler.Seçili izin modelini kullanarak Sınıf Not Defteri uygulamasına açıkça erişim vermelisiniz.

Gerekli İzinler

  • Sites.Selected kapsamı kullanılarak yalnızca uygulama erişimi.
  • EDU OneNote uygulamasına siteye tam denetim verin.

Ö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 Application’s Client Id
            "displayName": "EDU OneNote" //Target Application’s Display name
        }
    }]
}

Başvuru:

İzin API'si oluşturma

Siteler kullanan Uygulamalar Geliştirme.SPO siteleri için seçilen izinler

Microsoft 365 Geliştirici Blogu: Belirli SharePoint site koleksiyonlarında uygulama erişimini denetleme özelliği artık Microsoft Graph'ta kullanılabilir

3. Not Defteri Yönetimi için Mevcut API'leri kullanma

İzinler doğru yapılandırıldıktan sonra, aşağıdaki API'ler gibi mevcut Sınıf Not Defteri işlevselliği daha önce olduğu gibi çalışmaya devam etmelidir:

  • GetClassNotebook'lar

  • AddTeacher

  • AddStudent

  • CreateClassNotebook

    • Not: Yukarıda açıklandığı gibi, yeni Gruplar/Siteler için bunun yerine CreateEducationClass kullanın