Klargjør klassenotatblokker og nettsteder i stor skala ved hjelp av Microsoft Graph-API-er

Etter hvert som Microsoft forbedrer sikkerhetsstillingen på tvers av alle produkter og tjenester, har det nylig vært endringer i API-funksjonalitet som kan påvirke kunder som tidligere var avhengige av bare app-tillatelser for å klargjøre klassenotatblokker ved hjelp av API-er.

Du kan fremdeles klargjøre nettsteder og notatblokker i stor skala ved hjelp av Microsoft Graph-API-er ved å følge en støttet alternativ metode. Denne artikkelen beskriver trinnene og inneholder koblinger til relevant dokumentasjon.

Oversikt

Slik fortsetter du klargjøring av klassenotatblokker og SharePoint-områder i stor skala:

  1. Bruk CreateEducationClass-API-en når du oppretter nye områder (én gruppe/et område per klasse)
  2. For eksisterende nettsteder kan du bruke SharePoint CreatePermission-API-en til å gi AppId-tillatelser for OneNote-klassenotatblokk til dette nettstedet.
  3. Når trinnene ovenfor er fullført, bør eksisterende klassenotatblokkfunksjonalitet gjenopprettes, og API-kall som GetClassNotebooks, AddTeacher og addStudent skal fungere som forventet.

Trinnvise instruksjoner

1. Opprett nye områder med CreateEducationClass

Bruk CreateEducationClass-API-en til å opprette en ny Microsoft 365-gruppe og et tilknyttet SharePoint-område for hver klasse.

  • Denne API-en klargjør gruppe-, område- og tilknyttede ressurser i ett kall.
  • Når området er opprettet, kan du bruke eksisterende API-er til å behandle notatblokker og tillatelser.

Referanse: API-dokumentasjon for CreateEducationClass

2. Gi tillatelser til eksisterende områder

For eksisterende grupper eller områder må du eksplisitt gi tilgang til Klassenotatblokk-appen ved hjelp av Sites.Selected-tillatelsesmodellen .

Nødvendige tillatelser

  • App-bare tilgang ved hjelp av Sites.Selected scope.
  • Gi EDU OneNote-appen full kontroll til nettstedet.

Eksempelforespørsel

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 } }] }

Referanser:

Opprett tillatelses-API

Utvikle programmer som bruker Sites.Selected-tillatelser for SPO-områder

Utviklerblogg for Microsoft 365: Kontroll av apptilgang på bestemte SharePoint-områdesamlinger er nå tilgjengelig i Microsoft Graph

3. Bruk eksisterende API-er for behandling av notatblokker

Når tillatelsene er riktig konfigurert, bør eksisterende klassenotatblokkfunksjonalitet, for eksempel følgende API-er, fortsette å fungere som før:

  • GetClassNotebooks

  • AddTeacher

  • AddStudent

  • CreateClassNotebook

    • Obs! Som beskrevet ovenfor bruker du CreateEducationClass for nye grupper/områder i stedet