Inicjowanie obsługi notesów zajęć i witryn na dużą skalę przy użyciu interfejsów API programu Microsoft Graph

Firma Microsoft ulepsza zabezpieczenia we wszystkich produktach i usługach, dlatego wprowadzono ostatnio zmiany w funkcjach interfejsu API, które mogą mieć wpływ na klientów, którzy wcześniej polegali na uprawnieniach tylko do aplikacji w celu inicjowania obsługi notesów zajęć przy użyciu interfejsów API.

Nadal możesz aprowizować witryny i notesy na dużą skalę przy użyciu interfejsów API programu Microsoft Graph, postępując zgodnie z obsługiwaną metodą alternatywną. W tym artykule opisano poszczególne kroki i udostępniono linki do odpowiedniej dokumentacji.

Omówienie

Aby kontynuować inicjowanie obsługi notesów zajęć i witryn programu SharePoint na dużą skalę:

  1. Używanie interfejsu API CreateEducationClass podczas tworzenia nowych witryn (jedna grupa/witryna na zajęcia)
  2. W przypadku już istniejących witryn użyj interfejsu API CreatePermission programu SharePoint, aby udzielić uprawnień AppId notesu zajęć programu OneNote do danej witryny.
  3. Po wykonaniu powyższych czynności istniejące funkcje notesu zajęć powinny zostać przywrócone, a wywołania interfejsu API, takie jak GetClassNotebooks, AddTeacher i addStudent , powinny działać zgodnie z oczekiwaniami.

Instrukcje krok po kroku

1. Tworzenie nowych witryn za pomocą narzędzia CreateEducationClass

Użyj interfejsu API CreateEducationClass do utworzenia nowej grupy platformy Microsoft 365 i skojarzonej witryny programu SharePoint dla każdej klasy.

  • Ten interfejs API aprowizuje grupę, lokację i skojarzone zasoby w jednym wywołaniu.
  • Po utworzeniu witryny możesz używać istniejących interfejsów API do zarządzania notesami i uprawnieniami.

Dokumentacja: dokumentacja interfejsu API CreateEducationClass

2. Udzielanie uprawnień do istniejących witryn

W przypadku istniejących grup lub witryn musisz jawnie udzielić aplikacji Notes zajęć dostępu, korzystając z modelu uprawnień Witryny.Wybrane .

Wymagane uprawnienia

  • Dostęp tylko w aplikacji przy użyciu Sites.Selected zakresu.
  • Udziel aplikacji OneNote dla instytucji edukacyjnej (EDU) pełnej kontroli nad witryną.

Przykładowe żądanie

POST https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions Content-Type: application/json { "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "13291f5a-59ac-4c59-b0fa-d1632e8f3292", //identyfikator klienta aplikacji docelowej "displayName": "EDU OneNote" //Nazwa wyświetlana aplikacji docelowej } }] } }

Przypisy:

Tworzenie interfejsu API uprawnień

Tworzenie aplikacji korzystających z witryny Sites.Selected permissions for SPO sites

Blog deweloperów platformy Microsoft 365: kontrolowanie dostępu aplikacji do określonych zbiorów witryn programu SharePoint jest teraz dostępne w programie Microsoft Graph

3. Użyj istniejących interfejsów API do zarządzania notesami

Po prawidłowym skonfigurowaniu uprawnień istniejące funkcje notesu zajęć, takie jak następujące interfejsy API, powinny nadal działać jak wcześniej:

  • GetClassNotebooks (PobieranieNotesów)

  • Dodaj nauczyciela

  • DodajStudenta

  • CreateClassNotebook (UtwórzNotes_zajęć)

    • Uwaga: zgodnie z powyższym opisem, w przypadku nowych grup/witryn użyj zamiast tego polecenia CreateEducationClass