Configurar os tipos de separadores incorporados no Microsoft Teams

Para criar ou configurar um separador do Microsoft Teams com o Microsoft API do Graph, tem de conhecer a teamsAppId aplicação e , entityIdcontentUrl, removeUrle websiteUrl fornecer esse tipo de aplicação. Este artigo explica como obter esses valores para os tipos internos de guia.

Guias personalizadas

Para usar o Microsoft Graph para configurar uma guia associada a um provedor de guia que você escreveu, identifique o entityId, o contentUrl, o removeUrl e o websiteUrl que a interface do usuário de configuração do aplicativo fornece ao Microsoft Teams e passe os mesmos valores de entityId, contentUrl, removeUrl, e websiteUrl valores para o Microsoft Graph.

O teamsAppId é igual a id no esquema manifesto de aplicativo do Microsoft Teams.

Guias de site

Para as guias de site, o teamsAppId é com.microsoft.teamspace.tab.web. A configuração é a mostrada a seguir.

Guias do Word, Excel, PowerPoint e PDF

A tabela a seguir lista o teamsAppId para cada aplicativo.

A configuração é a mostrada a seguir.

Exemplo: criar uma guia configurada do Word

O exemplo a seguir criar uma guia configurada do Word.

POST https://graph.microsoft.com/v1.0/teams/{team-id}/channels/{channel-id}/tabs
{
  "displayName": "word",
  "teamsApp@odata.bind" : "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/com.microsoft.teamspace.tab.file.staticviewer.word",
  "configuration": {
     "entityId": "115A90F4-AC9C-4F79-9837-36D1EFB3BE08",
     "contentUrl": "https://m365x165177.sharepoint.com/sites/4NewCloneWithClonableParts/Shared%20Documents/General/Employee Handbook.docx",
     "removeUrl": null,
     "websiteUrl": null
  }
}

Guias de biblioteca de documentos

Para as guias de biblioteca de documentos, o teamsAppId é com.microsoft.teamspace.tab.files.sharepoint. A configuração é a mostrada a seguir.

Exemplo: criar um separador de biblioteca de documentos configurado

O exemplo seguinte cria um separador de biblioteca de documentos configurado.

POST https://graph.microsoft.com/v1.0/teams/{team-id}/channels/{channel-id}/tabs
{
    "displayName": "Document%20Library1",
    "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/com.microsoft.teamspace.tab.files.sharepoint",
    "configuration": {
        "entityId": "",
        "contentUrl": "https://microsoft.sharepoint.com/teams/WWWtest/Shared%20Documents",
        "removeUrl": null,
        "websiteUrl": null
    }
}

Guias da wiki

Para as guias da wiki, o teamsAppId é com.microsoft.teamspace.tab.wiki. Os separadores Wiki não suportam a configuração através do Microsoft Graph. No entanto, tenha em atenção que não há muito para configurar– num separador wiki não configurado, o primeiro utilizador só precisa de selecionar Configurar separador para o configurar.

Guias do Planner

Para Planner separadores, o teamsAppId é com.microsoft.teamspace.tab.planner. Essa configuração não é compatível.

Guias do Microsoft Stream

Para as guias do Microsoft Stream, o teamsAppId é com.microsoftstream.embed.skypeteamstab. Essa configuração não é compatível.

Guias do Microsoft Forms

Para as guias do Microsoft Forms, o teamsAppId é 81fef3a6-72aa-4648-a763-de824aeafb7d. Essa configuração não é compatível.

Guias do OneNote

Para as guias do OneNote, o teamsAppId é 0d820ecd-def2-4297-adad-78056cde7c78. Essa configuração não é compatível.

Guias do Power BI

Para as guias do Power BI, o teamsAppId é com.microsoft.teamspace.tab.powerbi. Essa configuração não é compatível.

Guias de lista e de página do SharePoint

Para as guias de lista e de página do SharePoint, o teamsAppId é 2a527703-1f6f-4559-a332-d8a7d288cd88. Essa configuração não é compatível.

separadores baseados em Estrutura do SharePoint

Os separadores personalizados criados com Estrutura do SharePoint podem ser criados com o Microsoft Graph, mas a configuração não é suportada.

Conteúdo relacionado

• Visão geral da API do Microsoft Teams