Integrar a sua aplicação Teams com tarefas de educação

A comunidade educativa tem um conjunto avançado de ferramentas e aplicações que melhoram a experiência para educadores e utilizadores. Pode utilizar as APIs do Microsoft Graph para disponibilizar a sua solução a professores e estudantes ao integrar a sua aplicação com tarefas no Teams.

Nota: Pode utilizar o Graph Explorer para testar as APIs mencionadas neste artigo.

Criar uma aplicação do Microsoft Teams

O Microsoft Teams oferece uma coleção de aplicativos fornecidos pela Microsoft ou serviços externos. As aplicações podem ser separadores, bots, extensões de mensagens ou recursos.

Para começar a criar a sua própria aplicação teams, consulte Criar uma nova aplicação do Teams.

Para obter as melhores práticas para integrar a sua aplicação Teams com tarefas, veja o exemplo de aplicações de tarefas.

Para obter detalhes sobre os requisitos de integração com o fluxo de atribuições no Teams, veja Requisitos de integração de aplicações de atribuição.

Pedido para ativar a sua aplicação Teams para fluxos de atribuição

Depois de criar e publicar a sua aplicação Teams, antes de poder integrar-se em tarefas, a sua aplicação tem de estar ativada. Para pedir a ativação da aplicação, preencha este formulário.

Adicionar a sua aplicação do Teams a uma tarefa

A sua aplicação do Teams pode ser adicionada como um recurso de atribuição .

  1. Obtenha o ID da aplicação com este ponto final. Não forneça um corpo do pedido.
GET /appCatalogs/teamsApps?$filter=displayName eq 'APPLICATION NAME'
  1. Anexe a aplicação Teams a uma tarefa.

Solicitação

O exemplo a seguir mostra uma solicitação. Utilize o ID do pedido anterior para o valor da propriedade 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"
    }
}

Response

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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. A Aplicação Teams está agora adicionada à tarefa e está disponível para os estudantes iniciarem.

Para obter um exemplo que mostra como integrar uma aplicação do Teams numa tarefa, veja Exemplo 7: Criar um educationTeamsAppResource.

Permissões

A API de atribuições suporta permissões delegadas (por utilizador) e apenas de aplicações (por aplicação). Para facilitar a utilização do estudante e do professor, são preferíveis permissões apenas para aplicações. Isto permite a aprovação da sua aplicação apenas para obter dados.

  • Last updated on