次の方法で共有


Microsoft Teams で組み込みのタブの種類を構成する

Microsoft Graph APIを使用して Microsoft Teams タブを作成または構成するには、アプリの と 、、 websiteUrlremoveUrlを知ってteamsAppIdentityIdcontentUrlその種類のアプリを提供する必要があります。 この記事では、組み込みタブ タイプのこれらの値を取得する方法について説明します。

カスタム タブ

Microsoft Graph を使用して、作成したタブ プロバイダー と関連付けるタブを構成するには、アプリの構成 UI が Microsoft Teams に提供するentityIdcontentUrlremoveUrlwebsiteUrl を識別し、同じ entityIdcontentUrlremoveUrlwebsiteUrl の値を Microsoft Graph に渡します。

teamsAppId は、Microsoft Teams のアプリ マニフェスト スキーマid と同じです。

Web サイトのタブ

Web サイトのタブの場合、teamsAppIdcom.microsoft.teamspace.tab.web です。 構成は以下のとおりです。

プロパティ 説明
entityId 文字列 Null
contentUrl 文字列 Web サイトの URL
removeUrl 文字列 Null
websiteUrl 文字列 Web サイトの URL

Word、Excel、PowerPoint、PDF のタブ

次の表は、各アプリの teamsAppId の一覧を示しています。

アプリ teamsAppId 種類 (拡張子)
Word com.microsoft.teamspace.tab.file.staticviewer.word docx
Excel com.microsoft.teamspace.tab.file.staticviewer.excel xlsx
PowerPoint com.microsoft.teamspace.tab.file.staticviewer.powerpoint pptx
PDF com.microsoft.teamspace.tab.file.staticviewer.pdf pdf

構成を次に示します。

プロパティ 説明
entityId 文字列 ファイルの sourceDoc ID。 これは、SharePoint でファイルを開き、アドレス バーを見ると確認できます。URL に sourcedoc=%7B{sourceDocId}%7D 句があります。 これは、ドキュメントの SharePoint ドライブ項目の webUrl から派生させることもできます。 詳細については、「GET /groups/{group-id}/drive/items/{item-id}」を参照してください。
contentUrl 文字列 ファイルの URL ({folder-webUrl}/{item-name} 形式)。 {folder-webUrl} はファイルを含む SharePoint フォルダーの webUrl です。これは SharePoint でファイルを開いてアドレス バーを確認するか、GET /groups/{group-id}/drive/items/{folder-item-id} から webUrl プロパティを使用することで確認できます。 {item-name} はファイル名です (例: file.docx)。これは GET /groups/{group-id}/drive/items/{item-id}name プロパティです。
removeUrl 文字列 Null
websiteUrl string Null

例: 構成された Word タブを作成する

次の例では、構成された 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
  }
}

ドキュメント ライブラリのタブ

ドキュメント ライブラリのタブの場合、teamsAppIdcom.microsoft.teamspace.tab.files.sharepoint です。 構成を次に示します。

プロパティ 説明
entityId 文字列 空の文字列 ("")
contentUrl string ドキュメント ライブラリのルート フォルダーの URL。 この URL を見つけるには、ブラウザーで SharePoint フォルダーを開き、URL をコピーし、"/Forms/AllItems.aspx" とその後のすべてを削除します。
removeUrl 文字列 Null
websiteUrl string Null

例: 構成済みのドキュメント ライブラリ タブを作成する

次の例では、構成済みのドキュメント ライブラリ タブを作成します。

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
    }
}

Wiki のタブ

Wiki のタブの場合、teamsAppIdcom.microsoft.teamspace.tab.wiki です。 Wiki タブでは、Microsoft Graph を使用した構成はサポートされていません。 ただし、構成する必要はあまりありません。未構成の Wiki タブでは、最初のユーザーは [ セットアップ] タブ を選択して構成するだけで済みます。

Planner のタブ

Planner タブの場合、 teamsAppId は ですcom.microsoft.teamspace.tab.planner。 構成はサポートされていません。

Microsoft Stream のタブ

Microsoft Stream のタブの場合、teamsAppIdcom.microsoftstream.embed.skypeteamstab です。 構成はサポートされていません。

Microsoft Forms のタブ

Microsoft Forms のタブの場合、teamsAppId81fef3a6-72aa-4648-a763-de824aeafb7d です。 構成はサポートされていません。

OneNote のタブ

OneNote のタブの場合、teamsAppId0d820ecd-def2-4297-adad-78056cde7c78 です。 構成はサポートされていません。

Power BI のタブ

Power BI のタブの場合、teamsAppIdcom.microsoft.teamspace.tab.powerbi です。 構成はサポートされていません。

SharePoint のページとリスト タブ

SharePoint のページとリスト タブの場合、teamsAppId2a527703-1f6f-4559-a332-d8a7d288cd88 です。 構成はサポートされていません。

SharePoint Framework ベースのタブ

SharePoint Frameworkを使用して構築されたカスタム タブは Microsoft Graph を使用して作成できますが、構成はサポートされていません。