Konfigurieren der integrierten Registerkartentypen in Microsoft TeamsConfiguring the built-in tab types in Microsoft Teams

Um eine Microsoft Teams-Registerkarte mithilfe von Microsoft Graph-APIs zu erstellen oder zu konfigurieren, müssen Sie die teamsAppId der App sowie die entityId, contentUrl, removeUrl und websiteUrl kennen, die für die Art der betreffenden App angegeben werden müssen.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. In diesem Artikel wird erläutert, wie Sie diese Werte für die integrierten Registerkartentypen abrufen.This article explains how to get those values for the built-in tab types.

Benutzerdefinierte RegisterkartenCustom tabs

Um Microsoft Graph zum Konfigurieren einer Registerkarte zu verwenden, die einem von Ihnen geschriebenen Registerkartenanbieterzugeordnet ist, identifizieren Sie die entityId, contentUrl, removeUrl und websiteUrl, die die Konfigurations-Benutzeroberfläche für Microsoft Teams bereitstellt, und übergeben Sie eben diese Werte für entityId, contentUrl, removeUrl und websiteUrl an 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.

Die teamsAppId ist die gleiche wie die id im App-Manifestschema für Microsoft Teams.The teamsAppId is the same as the id in the app manifest schema for Microsoft Teams.

Website-RegisterkartenWebsite tabs

Für Website-Registerkarten lautet die teamsAppId com.microsoft.teamspace.tab.web.For website tabs, the teamsAppId is com.microsoft.teamspace.tab.web. Die folgende Tabelle zeigt die Konfiguration.The following is the configuration.

EigenschaftProperty TypType BeschreibungDescription
entityIdentityId stringstring NullNull
contentUrlcontentUrl Zeichenfolgestring URL der WebsiteURL of the website
removeUrlremoveUrl stringstring NullNull
websiteUrlwebsiteUrl stringstring URL der WebsiteURL of the website

Planner-RegisterkartenPlanner tabs

Die teamsAppId für Planner-Registerkarten lautet com.microsoft.teamspace.tab.planner.For Planner tabs, the teamsAppId is com.microsoft.teamspace.tab.planner. Die folgende Tabelle zeigt die Konfiguration.The following is the configuration.

EigenschaftProperty TypType BeschreibungDescription
entityIdentityId stringstring Die Plan-ID (die ID, die für "GET /planner/plans/{id}" verwendet wird).The plan ID (the ID to use with GET /planner/plans/{id}).
contentUrlcontentUrl Zeichenfolgestring https://tasks.office.com/{tenantName}/Home/PlannerFrame?page=7&planId={planId}, wobei {tenantName} der Name des Mandanten (wie etwa "example.onmicrosoft.com") und {planId} gleich der Entitäts-ID ist.https://tasks.office.com/{tenantName}/Home/PlannerFrame?page=7&planId={planId}, where {tenantName} is the name of the tenant (such as example.onmicrosoft.com), and {planId} is the same as the entity ID.
removeUrlremoveUrl stringstring Gleicher Wert wie contentUrl.Same value as the contentUrl.
websiteUrlwebsiteUrl stringstring Gleicher Wert wie contentUrl.Same value as the contentUrl.

Informationen zum Erstellen eines neuen Plans zum Anzeigen auf Ihrer Planner-Registerkarte finden Sie unter plannerPlan erstellen.To create a new plan to display in your planner tab, see create plannerPlan.

Microsoft Stream-RegisterkartenMicrosoft Stream tabs

Für Microsoft Stream-Registerkarten ist die teamsAppId com.microsoftstream.embed.skypeteamstab.For Microsoft Stream tabs, the teamsAppId is com.microsoftstream.embed.skypeteamstab. Die folgende Tabelle zeigt die Konfiguration.The following is the configuration.

EigenschaftProperty TypType BeschreibungDescription
entityIdentityId stringstring NullNull
contentUrlcontentUrl Zeichenfolgestring https://web.microsoftstream.com/embed/video/{id}?autoplay=false&showinfo=true&app=microsoftteams&l={locale}, wobei {Id} die ID des Videostreams ist.https://web.microsoftstream.com/embed/video/{id}?autoplay=false&showinfo=true&app=microsoftteams&l={locale}, where {id} is the ID of the video stream. Um die {id} eines Streams zu ermitteln, öffnen Sie den Stream in einem Browser, und sehen Sie die URL an – sie weist die Form https://{domain}.microsoftstream.com/video/{id} auf.To find the {id} of a stream, open the stream in your browser and look at you the URL – it will be of the form https://{domain}.microsoftstream.com/video/{id}.
removeUrlremoveUrl stringstring NullNull
websiteUrlwebsiteUrl stringstring https://web.microsoftstream.com/video/{id}, wobei {id} die ID des Videostreams ist.https://web.microsoftstream.com/video/{id}, where {id} is the ID of the video stream.

Microsoft Forms-RegisterkartenMicrosoft Forms tabs

Für Microsoft Forms-Registerkarten ist die teamsAppId 81fef3a6-72aa-4648-a763-de824aeafb7d.For Microsoft Forms tabs, the teamsAppId is 81fef3a6-72aa-4648-a763-de824aeafb7d. Die folgende Tabelle zeigt die Konfiguration.The following is the configuration.

EigenschaftProperty TypType BeschreibungDescription
entityIdentityId stringstring Die ID des Formulars.The ID of the form. Definieren Sie diesen Wert, navigieren Sie zum Formular auf der Forms-Website, und suchen Sie die URL des Formulars https://forms.office.com/Pages/DesignPage.aspx#FormId={formId}.Define this value, navigate to the form in the Forms website, and find the URL of the form https://forms.office.com/Pages/DesignPage.aspx#FormId={formId}.
contentUrlcontentUrl Zeichenfolgestring https://forms.office.com/Pages/TeamsDesignPage.aspx?Host=Teams&lang={locale}&groupId={groupId}&tid={tid}&teamsTheme={theme}&upn={upn}&fragment=FormId%3D{formId}, wobei {formId} gleich der Entitäts-ID ist und {locale}, {groupId}, {tid} und {upn} Literale darstellen.https://forms.office.com/Pages/TeamsDesignPage.aspx?Host=Teams&lang={locale}&groupId={groupId}&tid={tid}&teamsTheme={theme}&upn={upn}&fragment=FormId%3D{formId}, where {formId} is the same as the entity ID, and {locale}, {groupId}, {tid}, {upn} are literals.
removeUrlremoveUrl stringstring NullNull
websiteUrlwebsiteUrl stringstring https://forms.office.com

Word-, Excel-, PowerPoint- und PDF-RegisterkartenWord, Excel, PowerPoint, and PDF tabs

In der folgenden Tabelle ist die teamsAppId für die einzelnen Apps aufgelistet.The following table lists the teamsAppId for each app.

AppApp teamsAppIdteamsAppId Typ (Erweiterung)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

Die folgende Tabelle zeigt die Konfiguration.The following is the configuration.

EigenschaftProperty TypType BeschreibungDescription
entityIdentityId stringstring Die sourceDoc-ID der Datei.The sourceDoc ID of the file. Sie finden diese, indem Sie die Datei in SharePoint öffnen und in die Adressleiste schauen – die URL weist eine sourcedoc=%7B{sourceDocId}%7D- Klausel auf.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. Sie können diese auch aus der webUrl des SharePoint-Laufwerkelements für das Dokument abrufen.You can also derive this from the webUrl of the SharePoint drive item for the document. Einzelheiten hierzu finden Sie unter GET /groups/{group-id}/drive/items/{item-id}.For details, see GET /groups/{group-id}/drive/items/{item-id}.
contentUrlcontentUrl Zeichenfolgestring Die URL der Datei im Format {folder-webUrl}/{item-name}.The URL of file in the format {folder-webUrl}/{item-name}. {folder-webUrl} ist die webUrl des SharePoint-Ordners, der die Datei enthält, die Sie finden, indem Sie die Datei in SharePoint öffnen und in die Adressleiste schauen, oder indem Sie die webUrl-Eigenschaft aus GET /groups/{group-id}/drive/items/{folder-item-id} verwenden.{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} ist der Dateiname (z. B. file.docx), der die name-Eigenschaft in GET /groups/{group-id}/drive/items/{item-id} darstellt.{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 NullNull
websiteUrlwebsiteUrl stringstring NullNull

Beispiel: Erstellen einer konfigurierten Word-RegisterkarteExample: Create a configured Word tab

Im folgenden Beispiel wird eine konfigurierte Word-Registerkarte erstellt.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/beta/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
  }
}

Wiki-RegisterkartenWiki tabs

Für Wiki-Registerkarten ist die teamsAppId com.microsoft.teamspace.tab.wiki.For wiki tabs, the teamsAppId is com.microsoft.teamspace.tab.wiki. Wiki-Registerkarten unterstützen die Konfiguration mithilfe von Graph nicht.Wiki tabs do not support configuration through Graph. Beachten Sie aber, dass es auch nicht viel zu konfigurieren gibt – auf einer nicht konfigurierten Wiki-Registerkarte muss der erste Benutzer lediglich auf Registerkarte einrichten klicken, um sie zu konfigurieren.Note, however, that there isn't much to configure -- in an un-configured wiki tab, the first user just needs to select Set up tab to configure it.

Registerkarten der DokumentbibliothekDocument library tabs

Für Registerkarten der Dokumentbibliothek ist die teamsAppId com.microsoft.teamspace.tab.files.sharepoint.For document library tabs, the teamsAppId is com.microsoft.teamspace.tab.files.sharepoint. Die folgende Tabelle zeigt die Konfiguration.The following is the configuration.

EigenschaftProperty TypType BeschreibungDescription
entityIdentityId stringstring Leere Zeichenfolge ("")Empty string ("")
contentUrlcontentUrl Zeichenfolgestring Die URL des Stammordners der Dokumentbibliothek.The URL of the root folder of the document library. Sie können diese URL finden, indem Sie den SharePoint-Ordner in Ihrem Browser öffnen, die URL kopieren und "/Forms/AllItems.aspx" und alles danach löschen.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 NullNull
websiteUrlwebsiteUrl stringstring NullNull

Beispiel: Erstellen einer konfigurierten Registerkarte "Dokumentbibliothek"Example: Create a configured document library tab

Im folgenden Beispiel wird eine konfigurierte Word-Registerkarte erstellt.The following example creates a configured Word 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
    }
}

OneNote-RegisterkartenOneNote tabs

Für OneNote-Registerkarten ist die teamsAppId 0d820ecd-def2-4297-adad-78056cde7c78.For OneNote tabs, the teamsAppId is 0d820ecd-def2-4297-adad-78056cde7c78. Die folgende Tabelle zeigt die Konfiguration.The following is the configuration.

EigenschaftProperty TypType BeschreibungDescription
entityIdentityId stringstring {randomGuid}_{notebookId}, wobei {randomGuid} eine von Ihnen generierte GUID ist.{randomGuid}_{notebookId}, where {randomGuid} is a GUID you generate.
contentUrlcontentUrl Zeichenfolgestring Eine https://www.onenote.com/teams/TabContent?entityid=%7BentityId%7D&subentityid=%7BsubEntityId%7D&auth_upn=%7Bupn%7D&notebookSource=New&notebookSelfUrl=https%3A%2F%2Fwww.onenote.com%2Fapi%2Fv1.0%2FmyOrganization%2Fgroups%2F{groupId}%2Fnotes%2Fnotebooks%2F{notebookId}&oneNoteWebUrl={oneNoteWebUrl}&notebookName=note&ui={locale}&tenantId={tid}URL des Formulars, wo {notebookId} und {oneNoteWebUrl} in Get/Groups/{ID}/OneNote/Notebooksgefunden werden kann.A URL of the form https://www.onenote.com/teams/TabContent?entityid=%7BentityId%7D&subentityid=%7BsubEntityId%7D&auth_upn=%7Bupn%7D&notebookSource=New&notebookSelfUrl=https%3A%2F%2Fwww.onenote.com%2Fapi%2Fv1.0%2FmyOrganization%2Fgroups%2F{groupId}%2Fnotes%2Fnotebooks%2F{notebookId}&oneNoteWebUrl={oneNoteWebUrl}&notebookName=note&ui={locale}&tenantId={tid}, where {notebookId} and {oneNoteWebUrl} can be found in GET /groups/{id}/onenote/notebooks. Schrägstrichen müssen Escapezeichen vorangestellt werden.Slashes must be escaped. {Gruppen-Nr}, {Gebietsschema} und {TID} sind Literale.{groupId}, {locale}, and {tid} are literals.
removeUrlremoveUrl stringstring Eine https://www.onenote.com/teams/TabRemove?entityid=%7BentityId%7D&subentityid=%7BsubEntityId%7D&auth_upn=%7Bupn%7D&notebookSource=New&notebookSelfUrl=https%3A%2F%2Fwww.onenote.com%2Fapi%2Fv1.0%2FmyOrganization%2Fgroups%2F{groupId}%2Fnotes%2Fnotebooks%2F{notebookId}&oneNoteWebUrl={oneNoteWebUrl}&notebookName=note&ui={locale}&tenantId={tid}URL des Formulars, wo {notebookId} und {oneNoteWebUrl} in Get/Groups/{ID}/OneNote/Notebooksgefunden werden kann.A URL of the form https://www.onenote.com/teams/TabRemove?entityid=%7BentityId%7D&subentityid=%7BsubEntityId%7D&auth_upn=%7Bupn%7D&notebookSource=New&notebookSelfUrl=https%3A%2F%2Fwww.onenote.com%2Fapi%2Fv1.0%2FmyOrganization%2Fgroups%2F{groupId}%2Fnotes%2Fnotebooks%2F{notebookId}&oneNoteWebUrl={oneNoteWebUrl}&notebookName=note&ui={locale}&tenantId={tid}, where {notebookId} and {oneNoteWebUrl} can be found in GET /groups/{id}/onenote/notebooks. Schrägstrichen müssen Escapezeichen vorangestellt werden.Slashes must be escaped. {Gruppen-Nr}, {Gebietsschema} und {TID} sind Literale.{groupId}, {locale} and {tid} are literals.
websiteUrlwebsiteUrl stringstring Eine URL der Form https://www.onenote.com/teams/TabRedirect?redirectUrl={oneNoteWebUrl}, wobei oneNoteWebUrl in GET /groups/{id}/onenote/notebooks zu finden ist.A URL of the form https://www.onenote.com/teams/TabRedirect?redirectUrl={oneNoteWebUrl}, where oneNoteWebUrl can be found in GET /groups/{id}/onenote/notebooks

Power BI-RegisterkartenPower BI tabs

Für Power BI-Registerkarten ist teamsAppId com.microsoft.teamspace.tab.powerbi.For Power BI tabs, the teamsAppId is com.microsoft.teamspace.tab.powerbi. Konfiguration wird nicht unterstützt.Configuration is not supported.

Registerkarten von SharePoint-Seiten und -ListenSharePoint page and list tabs

Für Registerkarten von SharePoint-Seiten und -Listen ist die teamsAppId 2a527703-1f6f-4559-a332-d8a7d288cd88.For SharePoint page and list tabs, the teamsAppId is 2a527703-1f6f-4559-a332-d8a7d288cd88. Konfiguration wird nicht unterstützt.Configuration is not supported. Wenn Sie die Registerkarte konfigurieren möchten, sollten Sie die Registerkarte „Website“ verwenden.If you want to configure the tab, consider using a Website tab.