Configurar tipos de guia internos no Microsoft TeamsConfiguring the built-in tab types in Microsoft Teams

Para criar ou configurar uma guia do Microsoft Teams usando as APIs REST do Microsoft Graph, você precisa saber a teamsAppId do aplicativo e entityId, contentUrl, removeUrl e websiteUrl a fornecer para esse tipo de aplicativo.To create or configure a Microsoft Teams tab using Microsoft Graph APIs, you need to know the teamsAppId of the app, and the entityId, contentUrl, removeUrl, and websiteUrl to provide for that kind of app. Este artigo explica como obter esses valores para os tipos internos de guia.This article explains how to get those values for the built-in tab types.

Guias personalizadasCustom tabs

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.To use Microsoft Graph to configure a tab associated with a tab provider that you wrote, identify the entityId, contentUrl, removeUrl, and websiteUrl that the app's configuration UI provides to Microsoft Teams, and pass the same entityId, contentUrl, removeUrl, and websiteUrl values to Microsoft Graph.

O teamsAppId é igual a id no esquema manifesto de aplicativo do Microsoft Teams.The teamsAppId is the same as the id in the app manifest schema for Microsoft Teams.

Guias de siteWebsite tabs

Para as guias de site, o teamsAppId é com.microsoft.teamspace.tab.web.For website tabs, the teamsAppId is com.microsoft.teamspace.tab.web. A configuração é a mostrada a seguir.The following is the configuration.

PropriedadeProperty TipoType DescriçãoDescription
entityIdentityId stringstring NuloNull
contentUrlcontentUrl stringstring URL do siteURL of the website
removeUrlremoveUrl stringstring NuloNull
websiteUrlwebsiteUrl stringstring URL do siteURL of the website

Guias do Word, Excel, PowerPoint e PDFWord, Excel, PowerPoint, and PDF tabs

A tabela a seguir lista o teamsAppId para cada aplicativo.The following table lists the teamsAppId for each app.

AppApp teamsAppIdteamsAppId tipo (extensão)type (extension)
WordWord com.microsoft.teamspace.tab.file.staticviewer.word docx
ExcelExcel com.microsoft.teamspace.tab.file.staticviewer.excel xlsx
PowerPointPowerPoint com.microsoft.teamspace.tab.file.staticviewer.powerpoint pptx
PDFPDF com.microsoft.teamspace.tab.file.staticviewer.pdf pdf

A configuração é a mostrada a seguir.The following is the configuration.

PropriedadeProperty TipoType DescriçãoDescription
entityIdentityId stringstring A ID de sourceDoc do arquivo.The sourceDoc ID of the file. Para encontrá-la, abra o arquivo no SharePoint e procure a barra de endereços - a URL terá uma cláusula sourcedoc=%7B{sourceDocId}%7D.You can find this by opening the file in SharePoint and looking at the address bar – the URL will have a sourcedoc=%7B{sourceDocId}%7D clause. Você também pode derivar isso na webUrl do item de unidade do SharePoint para o documento.You can also derive this from the webUrl of the SharePoint drive item for the document. Para saber mais, confira GET /groups/{group-id}/drive/items/{item-id}.For details, see GET /groups/{group-id}/drive/items/{item-id}.
contentUrlcontentUrl stringstring A URL do arquivo no formato {folder-webUrl}/{item-name}.The URL of file in the format {folder-webUrl}/{item-name}. {folder-webUrl} é a webUrl da pasta do SharePoint que contém o arquivo. Para localizá-la, abra o arquivo no SharePoint e procure na barra de endereços, ou use a propriedade webUrl em GET /groups/{group-id}/drive/items/{folder-item-id}.{folder-webUrl} is the webUrl of the SharePoint folder containing the file, which can be found by opening the file in SharePoint and looking at the address bar, or by using the webUrl property from GET /groups/{group-id}/drive/items/{folder-item-id}. {item-name} é o nome do arquivo (por exemplo, file.docx), que é a propriedade name em GET /groups/{group-id}/drive/items/{item-id}.{item-name} is the file name (for example, file.docx), which is the name property in GET /groups/{group-id}/drive/items/{item-id}.
removeUrlremoveUrl stringstring NuloNull
websiteUrlwebsiteUrl stringstring NuloNull

Exemplo: criar uma guia configurada do WordExample: Create a configured Word tab

O exemplo a seguir criar uma guia configurada do Word.The following example creates a configured Word tab.

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 documentosDocument library tabs

Para as guias de biblioteca de documentos, o teamsAppId é com.microsoft.teamspace.tab.files.sharepoint.For document library tabs, the teamsAppId is com.microsoft.teamspace.tab.files.sharepoint. A configuração é a mostrada a seguir.The following is the configuration.

PropriedadeProperty TipoType DescriçãoDescription
entityIdentityId stringstring Cadeia de caracteres vazia ("")Empty string ("")
contentUrlcontentUrl stringstring A URL da pasta raiz da biblioteca de documentos.The URL of the root folder of the document library. Você pode encontrar essa URL abrindo a pasta do SharePoint no navegador, copiando a URL e excluindo "/Forms/AllItems.aspx" e tudo depois disso.You can find this URL by opening the SharePoint folder in your browser, copying the URL, and deleting "/Forms/AllItems.aspx" and everything after that.
removeUrlremoveUrl stringstring NuloNull
websiteUrlwebsiteUrl stringstring NuloNull

Exemplo: Criar uma guia configurada da biblioteca de documentosExample: Create a configured document library tab

O exemplo a seguir cria uma guia configurada da biblioteca de documentos.The following example creates a configured document library tab.

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 wikiWiki tabs

Para as guias da wiki, o teamsAppId é com.microsoft.teamspace.tab.wiki.For wiki tabs, the teamsAppId is com.microsoft.teamspace.tab.wiki. As guias Wiki não são suportadas pela configuração por meio do Microsoft Graph.Wiki tabs do not support configuration through Microsoft Graph. Observe, no entanto, que não há muito para configurar – em uma guia wiki não configurada, o primeiro usuário só precisa selecionar a guia Configurar para configurá-la.Note, however, that there isn't much to configure - in an unconfigured wiki tab, the first user just needs to select Set up tab to configure it.

Guias do PlannerPlanner tabs

Para guias do Planner, teamsAppId o valor é com.microsoft.teamspace.tab.planner .For Planner tabs, the teamsAppId is com.microsoft.teamspace.tab.planner. Essa configuração não é compatível.Configuration is not supported.

Guias do Microsoft StreamMicrosoft Stream tabs

Para as guias do Microsoft Stream, o teamsAppId é com.microsoftstream.embed.skypeteamstab.For Microsoft Stream tabs, the teamsAppId is com.microsoftstream.embed.skypeteamstab. Essa configuração não é compatível.Configuration is not supported.

Guias do Microsoft FormsMicrosoft Forms tabs

Para as guias do Microsoft Forms, o teamsAppId é 81fef3a6-72aa-4648-a763-de824aeafb7d.For Microsoft Forms tabs, the teamsAppId is 81fef3a6-72aa-4648-a763-de824aeafb7d. Essa configuração não é compatível.Configuration is not supported.

Guias do OneNoteOneNote tabs

Para as guias do OneNote, o teamsAppId é 0d820ecd-def2-4297-adad-78056cde7c78.For OneNote tabs, the teamsAppId is 0d820ecd-def2-4297-adad-78056cde7c78. Essa configuração não é compatível.Configuration is not supported.

Guias do Power BIPower BI tabs

Para as guias do Power BI, o teamsAppId é com.microsoft.teamspace.tab.powerbi.For Power BI tabs, the teamsAppId is com.microsoft.teamspace.tab.powerbi. Essa configuração não é compatível.Configuration is not supported.

Guias de lista e de página do SharePointSharePoint page and list tabs

Para as guias de lista e de página do SharePoint, o teamsAppId é 2a527703-1f6f-4559-a332-d8a7d288cd88.For SharePoint page and list tabs, the teamsAppId is 2a527703-1f6f-4559-a332-d8a7d288cd88. Essa configuração não é compatível.Configuration is not supported. Se você quiser configurar a guia, considere usar uma guia do site.If you want to configure the tab, consider using a Website tab.