Aprovisionamiento de blocs de notas de clase y sitios a escala con las API de Microsoft Graph

A medida que Microsoft mejora su posición de seguridad en todos los productos y servicios, ha habido cambios recientes en la funcionalidad de la API que pueden afectar a los clientes que antes confiaban en permisos de solo aplicación para aprovisionar blocs de notas de clase con API.

Aún puede aprovisionar sitios y blocs de notas a escala con las API de Microsoft Graph siguiendo un método alternativo admitido. En este artículo se describen los pasos y se proporcionan vínculos a la documentación pertinente.

Información general

Para seguir aprovisionando blocs de notas de clase y sitios de SharePoint a escala:

  1. Usar la API CreateEducationClass al crear nuevos sitios (un grupo o sitio por clase)
  2. Para los sitios preexistedos, use la API CreatePermission de SharePoint para conceder permisisonas de AppId de Bloc de notas de clase de OneNote a ese sitio.
  3. Una vez completados los pasos anteriores, debería restaurarse la funcionalidad existente de Bloc de notas de clase y las llamadas a la API como GetClassNotebooks, AddTeacher y addStudent deberían funcionar según lo esperado.

Instrucciones paso a paso

1. Crear nuevos sitios con CreateEducationClass

Use la API CreateEducationClass para crear un nuevo grupo de Microsoft 365 y un sitio de SharePoint asociado para cada clase.

  • Esta API aprovisiona el grupo, el sitio y los recursos asociados en una llamada.
  • Después de crear el sitio, puede usar las API existentes para administrar blocs de notas y permisos.

Referencia: Documentación de la API CreateEducationClass

2. Conceder permisos a sitios existentes

Para los grupos o sitios existentes, debe conceder explícitamente acceso a la aplicación Bloc de notas de clase mediante el modelo de permisos Sites.Selected .

Permisos necesarios

  • Acceso solo a la aplicación mediante Sitios.Ámbito seleccionado.
  • Conceda al sitio el control total de la aplicación Edu OneNote.

Solicitud de ejemplo

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

Referencias:

Crear API de permisos

Desarrollar aplicaciones que usan Sitios.Permisos seleccionados para sitios de SPO

Blog para desarrolladores de Microsoft 365: Controlar el acceso a aplicaciones en colecciones de sitios de SharePoint específicas ya está disponible en Microsoft Graph

3. Usar LAS API existentes para la administración de blocs de notas

Una vez que los permisos estén configurados correctamente, la funcionalidad existente de Bloc de notas de clase, como las siguientes API, debería seguir funcionando como antes:

  • GetClassNotebooks

  • AddTeacher

  • AddStudent

  • CreateClassNotebook

    • Nota: como se describió anteriormente, para nuevos grupos o sitios, use CreateEducationClass en su lugar