Klargjøre 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 vært nylige endringer i API-funksjonalitet som kan påvirke kunder som tidligere var avhengige av kun app-tillatelser for å klargjøre klassenotatblokker ved hjelp av API-er.

Du kan fortsatt 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-nettsteder i stor skala:

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

Trinnvise instruksjoner

1. Opprett nye nettsteder med CreateEducationClass

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

  • Denne API-en klargjør gruppen, området og tilknyttede ressurser i én samtale.
  • Når området er opprettet, kan du bruke eksisterende API-er til å administrere notatblokker og tillatelser.

Referanse: Dokumentasjon for CreateEducationClass API

2. Gi tillatelser til eksisterende nettsteder

For eksisterende grupper eller nettsteder må du eksplisitt gi klassenotatblokk-appen tilgang ved hjelp av tillatelsesmodellen Sites.Selected .

Nødvendige tillatelser

  • Kun app-tilgang ved hjelp av Sites.Selected-omfanget.
  • Gi EDU OneNote-appen full kontroll over nettstedet.

Eksempel på forespø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", //målprogrammets klient-ID "displayName": "EDU OneNote" //Displayname for målprogrammet } }] }

Referanser:

Opprett tillatelses-API

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

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

3. Bruke eksisterende API-er for notatblokkadministrasjon

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

  • GetClassNotebooks

  • AddTeacher

  • Legg til student

  • CreateClassNotebook

    • Obs! Som beskrevet ovenfor, for nye grupper/nettsteder, bruker du CreateEducationClass i stedet