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

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

カスタム タブ

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

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

Web サイトのタブ

Web サイトのタブの場合、teamsAppId は com.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
  }
}

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

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

プロパティ 型 説明
entityId string 空の文字列 ("")
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 のタブの場合、teamsAppId は com.microsoft.teamspace.tab.wiki です。 Wiki タブでは、Microsoft Graph を使用した構成はサポートされていません。 ただし、構成する必要はあまりありません。未構成の Wiki タブでは、最初のユーザーは [ セットアップ] タブ を選択して構成するだけで済みます。

Planner のタブ

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

Microsoft Stream のタブ

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

Microsoft Forms のタブ

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

OneNote のタブ

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

Power BI のタブ

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

SharePoint のページとリスト タブ

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

SharePoint Framework ベースのタブ

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

関連コンテンツ

  • 最終更新: