Integración de la aplicación de Teams con asignaciones educativas

  • Artículo

La comunidad educativa tiene un amplio conjunto de herramientas y aplicaciones que mejoran la experiencia de educadores y usuarios. Puede usar las API de Microsoft Graph para que la solución esté disponible para profesores y alumnos mediante la integración de la aplicación con asignaciones en Teams.

Nota: Puede usar el Explorador de Graph para probar las API mencionadas en este artículo.

Creación de una aplicación de Microsoft Teams

Microsoft Teams ofrece una colección de aplicaciones proporcionadas por Microsoft o por servicios externos. Las aplicaciones pueden ser pestañas, bots, extensiones de mensajes o recursos.

Para empezar a compilar su propia aplicación de Teams, consulte Creación de una nueva aplicación de Teams.

Para ver los procedimientos recomendados para integrar la aplicación de Teams con asignaciones, consulte el ejemplo de aplicaciones de asignación.

Para obtener más información sobre los requisitos para la integración con el flujo de asignaciones en Teams, consulte Requisitos de integración de aplicaciones de asignación.

Solicitud para habilitar la aplicación de Teams para flujos de asignación

Después de crear y publicar la aplicación de Teams, para poder integrarla con asignaciones, la aplicación debe estar habilitada. Para solicitar que la aplicación esté habilitada, complete este formulario.

Agregar la aplicación de Teams a una asignación

La aplicación de Teams se puede agregar como un recurso de asignación .

  1. Obtenga el identificador de aplicación mediante este punto de conexión. No proporcione un cuerpo de solicitud.
GET /appCatalogs/teamsApps?$filter=displayName eq 'APPLICATION NAME'
  1. Asocie la aplicación de Teams a una asignación.

Solicitud

En el ejemplo siguiente se muestra la solicitud. Use el identificador de la solicitud anterior para el valor de la propiedad appId .

POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/1618dfb0-3ff2-4edf-8d5c-b8f81df00e80/resources
Content-type: application/json

{
    "distributeForStudentWork": false,
    "resource": {
        "contentUrl": "https://sd-prod-us-web-galileo.azurewebsites.net/assets/content.html",
        "appId": "7caaa66b-34b0-4c15-a65d-dba6edf0c8fd",
        "appIconUrl": "https://statics.teams.cdn.office.net/evergreen-assets/ThirdPartyApps/7caaa66b-34b0-4c15-a65d-dba6edf0c8fd_largeImage.png?v=1.3.0",
        "displayName": "School Day",
        "websiteUrl": "https://sd-prod-us-web-galileo.azurewebsites.net/",
        "@odata.type": "#microsoft.graph.educationTeamsAppResource"
    }
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('72a7baec-c3e9-4213-a850-f62de0adad5f')/assignments('1618dfb0-3ff2-4edf-8d5c-b8f81df00e80')/resources/$entity",
    "distributeForStudentWork": false,
    "status": "published",
    "id": "de220fbc-865a-4c8e-a013-fc5dabe0f817",
    "resource": {
        "@odata.type": "#microsoft.graph.educationTeamsAppResource",
        "displayName": "School Day",
        "createdDateTime": "2022-12-21T02:17:01.9365101Z",
        "lastModifiedDateTime": "2022-12-21T02:17:01.9365342Z",
        "appId": "7caaa66b-34b0-4c15-a65d-dba6edf0c8fd",
        "appIconUrl": "https://statics.teams.cdn.office.net/evergreen-assets/ThirdPartyApps/7caaa66b-34b0-4c15-a65d-dba6edf0c8fd_largeImage.png?v=1.3.0",
        "contentUrl": "https://sd-prod-us-web-galileo.azurewebsites.net/assets/content.html",
        "websiteUrl": "https://sd-prod-us-web-galileo.azurewebsites.net/",
        "createdBy": {
            "application": null,
            "device": null,
            "user": {
                "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
                "displayName": null
            }
        },
        "lastModifiedBy": {
            "application": null,
            "device": null,
            "user": {
                "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
                "displayName": null
            }
        }
    }
}
  1. La aplicación teams ahora se agrega a la asignación y está disponible para que los alumnos se inicien.

Para obtener un ejemplo que muestra cómo integrar una aplicación de Teams con una asignación, vea Ejemplo 7: Crear un educationTeamsAppResource.

Permissions

La API de asignaciones admite permisos delegados (por usuario) y solo de aplicación (por aplicación). Para facilitar el uso de los alumnos y profesores, se prefieren los permisos de solo aplicación. Esto permite la aprobación de la aplicación solo para recuperar datos.