アプリ マニフェスト

アプリ マニフェスト (以前は Teams アプリ マニフェスト) では、アプリがMicrosoft Teams製品に統合される方法について説明します。 アプリ マニフェストは、https://developer.microsoft.com/json-schemas/teams/v1.19/MicrosoftTeams.schema.json でホストされているスキーマに準拠している必要があります。 以前のバージョン 1.0、1.1,...,1.17、および現在のバージョンはそれぞれ 1.19 です (URL で "v1.x" を使用)。 バージョン 1.18 は使用できません。 各バージョンで行われた変更の詳細については、「 アプリ マニフェストの変更ログ 」を参照し、以前のバージョンについては、「 アプリ マニフェストのバージョン」を参照してください。

次の表は、さまざまなアプリのシナリオに応じた TeamsJS バージョンとアプリ マニフェスト バージョンを示しています。

* Teams 専用アプリを含む最新の機能強化と新機能のサポートを利用するには、可能な限り最新の TeamsJS (v.2.19.0 以降) を使用します。TeamsJS v.1.12 は引き続きサポートされますが、新機能や機能強化は追加されません。1.12 スキーマと 1.13 スキーマは同じです。詳細については、「 TeamsJS ライブラリ」を参照してください。

アプリ マニフェスト スキーマのサンプルを次に示します。

サンプル アプリ マニフェスト

{
    "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.19/MicrosoftTeams.schema.json",
    "manifestVersion": "1.19",
    "version": "1.0.0",
    "id": "%MICROSOFT-APP-ID%",
    "localizationInfo": {
        "defaultLanguageTag": "en",
        "defaultLanguageFile": "en.json",
        "additionalLanguages": [
            {
                "languageTag": "es",
                "file": "es.json"
            }
        ]
    },
    "developer": {
        "name": "Publisher Name",
        "websiteUrl": "https://example.com/",
        "privacyUrl": "https://example.com/privacy",
        "termsOfUseUrl": "https://example.com/app-tos",
        "mpnId": "1234567890"
    },
    "name": {
        "short": "Name of your app (<=30 chars)",
        "full": "Full name of app, if longer than 30 characters (<=100 chars)"
    },
    "description": {
        "short": "Short description of your app (<= 80 chars)",
        "full": "Full description of your app (<= 4000 chars)"
    },
    "icons": {
        "outline": "A relative path to a transparent .png icon — 32px X 32px",
        "color": "A relative path to a full color .png icon — 192px X 192px"
    },
    "accentColor": "A valid HTML color code.",
    "copilotAgents": {
        "declarativeAgents": [
            {
                "id": "agent1",
                "file": "declarativeAgent1.json"
            }
        ]
    },
    "configurableTabs": [
        {
            "configurationUrl": "https://contoso.com/teamstab/configure",
            "scopes": [
                "team",
                "groupChat"
            ],
            "canUpdateConfiguration": true,
            "context": [
                "channelTab",
                "privateChatTab",
                "meetingChatTab",
                "meetingDetailsTab",
                "meetingSidePanel",
                "meetingStage"
            ],
            "sharePointPreviewImage": "Relative path to a tab preview image for use in SharePoint — 1024px X 768",
            "supportedSharePointHosts": [
                "sharePointFullPage",
                "sharePointWebPart"
            ]
        }
    ],
    "staticTabs": [
        {
            "entityId": "unique Id for the page entity",
            "scopes": [
                "personal"
            ],
            "context": [
                "personalTab",
                "channelTab"
            ],
            "name": "Display name of tab",
            "contentUrl": "https://contoso.com/content (displayed in Teams canvas)",
            "websiteUrl": "https://contoso.com/content (displayed in web browser)",
            "searchUrl": "https://contoso.com/content (displayed in web browser)"
        }
    ],
    "supportedChannelTypes": [
        "sharedChannels",
        "privateChannels"
    ],
    "bots": [
        {
            "botId": "%MICROSOFT-APP-ID-REGISTERED-WITH-BOT-FRAMEWORK%",
            "scopes": [
                "team",
                "personal",
                "groupChat"
            ],
            "needsChannelSelector": false,
            "isNotificationOnly": false,
            "supportsFiles": true,
            "supportsCalling": false,
            "supportsVideo": true,
            "commandLists": [
                {
                    "scopes": [
                        "team",
                        "groupChat"
                    ],
                    "commands": [
                        {
                            "title": "Command 1",
                            "description": "Description of Command 1"
                        },
                        {
                            "title": "Command 2",
                            "description": "Description of Command 2"
                        }
                    ]
                },
                {
                    "scopes": [
                        "personal",
                        "groupChat"
                    ],
                    "commands": [
                        {
                            "title": "Personal command 1",
                            "description": "Description of Personal command 1"
                        },
                        {
                            "title": "Personal command N",
                            "description": "Description of Personal command N"
                        }
                    ]
                }
            ]
        }
    ],
    "connectors": [
        {
            "connectorId": "GUID-FROM-CONNECTOR-DEV-PORTAL%",
            "scopes": [
                "team"
            ],
            "configurationUrl": "https://contoso.com/teamsconnector/configure"
        }
    ],
    "composeExtensions": [
        {
            "canUpdateConfiguration": true,
            "botId": "%MICROSOFT-APP-ID-REGISTERED-WITH-BOT-FRAMEWORK%",
            "commands": [
                {
                    "id": "exampleCmd1",
                    "title": "Example Command",
                    "type": "query",
                    "context": [
                        "compose",
                        "commandBox"
                    ],
                    "description": "Command Description; e.g., Search on the web",
                    "initialRun": true,
                    "fetchTask": false,
                    "parameters": [
                        {
                            "name": "keyword",
                            "title": "Search keywords",
                            "inputType": "choiceset",
                            "description": "Enter the keywords to search for",
                            "value": "Initial value for the parameter",
                            "choices": [
                                {
                                    "title": "Title of the choice",
                                    "value": "Value of the choice"
                                }
                            ]
                        }
                    ]
                },
                {
                    "id": "exampleCmd2",
                    "title": "Example Command 2",
                    "type": "action",
                    "context": [
                        "message"
                    ],
                    "description": "Command Description; e.g., Add a customer",
                    "initialRun": true,
                    "fetchTask": false ,
                    "parameters": [
                        {
                            "name": "custinfo",
                            "title": "Customer name",
                            "description": "Enter a customer name",
                            "inputType": "text"
                        }
                    ]
                },
                {
                    "id": "exampleCmd3",
                    "title": "Example Command 3",
                    "type": "action",
                    "context": [
                        "compose",
                        "commandBox",
                        "message"
                    ],
                    "description": "Command Description; e.g., Add a customer",
                    "fetchTask": false,
                    "taskInfo": {
                        "title": "Initial dialog title",
                        "width": "Dialog width",
                        "height": "Dialog height",
                        "url": "Initial webview URL"
                    }
                }
            ],
            "messageHandlers": [
                {
                    "type": "link",
                    "value": {
                        "domains": [
                            "mysite.someplace.com",
                            "othersite.someplace.com"
                        ],
                        "supportsAnonymizedPayloads": false
                    }
                }
            ]
        }
    ],
    "permissions": [
        "identity",
        "messageTeamMembers"
    ],
    "devicePermissions": [
        "geolocation",
        "media",
        "notifications",
        "midi",
        "openExternal"
    ],
    "validDomains": [
        "contoso.com",
        "mysite.someplace.com",
        "othersite.someplace.com"
    ],
    "webApplicationInfo": {
        "id": "AAD App ID",
        "resource": "Resource URL for acquiring auth token for SSO"
    },
    "authorization": {
        "permissions": {
            "resourceSpecific": [
                {
                    "type": "Application",
                    "name": "ChannelSettings.Read.Group"
                },
                {
                    "type": "Delegated",
                    "name": "ChannelMeetingParticipant.Read.Group"
                }
            ]
        }
    },
    "showLoadingIndicator": false,
    "isFullScreen": false,
    "activities": {
        "activityTypes": [
            {
                "type": "taskCreated",
                "description": "Task created activity",
                "templateText": "<team member> created task <taskId> for you"
            },
            {
                "type": "userMention",
                "description": "Personal mention activity",
                "templateText": "<team member> mentioned you"
            }
        ]
    },
    "defaultBlockUntilAdminAction": true,
    "publisherDocsUrl": "https://example.com/app-info",
    "defaultInstallScope": "meetings",
    "defaultGroupCapability": {
        "meetings": "tab",
        "team": "bot",
        "groupchat": "bot"
    },
    "configurableProperties": [
        "name",
        "shortDescription",
        "longDescription",
        "smallImageUrl",
        "largeImageUrl",
        "accentColor",
        "developerUrl",
        "privacyUrl",
        "termsOfUseUrl"
    ],
    "subscriptionOffer": {
        "offerId": "publisherId.offerId"
    },
    "meetingExtensionDefinition": {
        "scenes": [
            {
                "id": "9082c811-7e6a-4174-8173-6ccd57d377e6",
                "name": "Getting started sample",
                "file": "scenes/sceneMetadata.json",
                "preview": "scenes/scenePreview.png",
                "maxAudience": 15,
                "seatsReservedForOrganizersOrPresenters": 0
            },
            {
                "id": "afeaed22-f89b-48e1-98b4-46a514344e4a",
                "name": "Sample-1",
                "file": "scenes/sceneMetadata.json",
                "preview": "scenes/scenePreview.png",
                "maxAudience": 15,
                "seatsReservedForOrganizersOrPresenters": 3
            }
        ]
    }
}

スキーマは次のプロパティを定義します。

$schema

省略可能ですが、推奨 – 文字列

アプリ マニフェストの JSON スキーマを参照する https:// URL。

manifestVersion

必須 – 文字列

このマニフェストで使用されているアプリ マニフェスト スキーマのバージョン。 1.13 Outlook と Microsoft 365 アプリで Teams アプリのサポートを有効にするには、 を使用します。Teams 専用アプリには (またはそれ以前のバージョン) を使用1.12します。

version

必須 – 文字列

特定のアプリのバージョン。 アプリ マニフェストで何かを更新する場合は、バージョンもインクリメントする必要があります。 これにより、新しいアプリ マニフェストがインストールされると、既存のマニフェストが上書きされ、ユーザーは新しい機能を受け取ります。 このアプリが Microsoft Teams ストアに送信されたら、新しいアプリ マニフェストを再送信して再検証する必要があります。 アプリ ユーザーは、アプリ マニフェストが承認されてから数時間後に、更新された新しいアプリ マニフェストを自動的に受け取ります。

アプリが権限の変更を要求した場合、ユーザーはアプリをアップグレードして再承認するよう求められます。

このバージョン文字列は、semver 標準 (MAJOR.MINOR.PATCH) に従う必要があります。

ID

必須 – Microsoft アプリ ID

ID は、Microsoft が生成したアプリの一意の識別子です。 ID の形式は GUID です。 ボットが Microsoft Bot Framework を介して登録されている場合は、ID があります。 タブの Web アプリが既に Microsoft にサインインしている場合は、ID があります。 ここに ID を入力する必要があります。 それ以外の場合は、Microsoft アプリケーション登録ポータルで新しい ID を生成する必要があります。 ボットを追加する場合は、同じ ID を使用してください。

Teams 管理 センターに格納されている ID は外部アプリ ID であり、トレースでは ExternalID として表示されます。

developer

必須 – オブジェクト

会社に関する情報を指定します。 Teams ストアに送信されるアプリの場合、これらの値は Teams ストアの登録情報の情報と一致する必要があります。 詳細については、 Teams ストアの発行ガイドラインに関するページを参照してください。 開発者名は、Teams ストアでのアプリの検出可能性を高めるのに役立ちます。

name

必須 – オブジェクト

Teams エクスペリエンスでユーザーに表示されるアプリ エクスペリエンスの名前。 AppSource に送信されるアプリの場合、これらの値は AppSource エントリの情報と一致する必要があります。 short と full の値は異なっている必要があります。 アプリ名は、Teams ストアでのアプリの検出可能性を高めるのに役立ちます。

説明

必須 – オブジェクト

アプリについてユーザーに説明します。 AppSource に送信されるアプリの場合、これらの値は AppSource エントリの情報と一致する必要があります。 アプリの説明は、Teams ストアでのアプリの検出可能性を向上させるのに役立ちます。

説明があなたの経験をについて述べており、潜在的な顧客があなたの経験が何をするかを理解するのに役立つことを確認してください。 外部アカウントを使用する必要がある場合は、完全な説明にするよう気を配る必要があります。 short と full の値は異なっている必要があります。 短い説明は長い説明の中で繰り返すことはできません。また、他のアプリ名を含めることはできません。

localizationInfo

省略可能 – オブジェクト

既定の言語の指定と、追加の言語ファイルへのポインターを許可します。 ローカリゼーションを参照してください。

localizationInfo.additionalLanguages

次のプロパティを持つオブジェクトの配列で、追加の言語翻訳を指定します。

アイコン

必須 – オブジェクト

Teams アプリ内で使用されるアイコン。 アイコン ファイルは、アップロード パッケージの一部として含まれている必要があります。 詳細については、アイコンを参照してください。

accentColor

必須 – HTML 16 進カラー コード

使用する色と、色アイコンの背景として。

値は、'#' で始まる有効な HTML カラー コードである必要があります (例; #4464ee)。 詳細については、「 accentColor」を参照してください。

copilotAgents

省略可能 – オブジェクト

Microsoft 365 Copilotする 1 つ以上のエージェントを定義します。 宣言型エージェントは、同じオーケストレーターと基盤モデルで実行されるMicrosoft 365 Copilotのカスタマイズです。

declarativeAgents

マニフェスト ファイルで定義されているMicrosoft 365 Copilotのカスタマイズを表します。

configurableTabs

省略可能 – 配列

アプリ エクスペリエンスにチーム チャネル タブ エクスペリエンスがあり、追加する前に追加の構成が必要な場合に使用されます。 構成可能なタブは、team スコープおよび groupChat スコープでのみサポートされており、同じタブを複数回構成できます。 ただし、アプリ マニフェストで定義できるのは 1 回だけです。

staticTabs

省略可能 – 配列

ユーザーが手動で追加することなく、既定でピン留めできる一連のタブを定義します。 personal スコープで宣言された静的タブは、常にアプリの個人的なエクスペリエンスに固定されます。

このアイテムは、型 object のすべての要素を持つ配列 (最大 16 要素) です。 このブロックは、静的タブ ソリューションを提供するソリューションにのみ必要です。

ボット

省略可能 – 配列

既定のコマンド プロパティなどのオプション情報とともに、ボット ソリューションを定義します。

項目は配列です (最大 1 つの要素のみ(アプリごとに 1 つのボットのみが許可されます)、型 objectのすべての要素が含まれます。 このブロックは、ボット エクスペリエンスを提供するソリューションにのみ必要です。

bots.configuration

省略可能 – オブジェクト

bots.commandLists

省略可能 – 配列

ボットがユーザーに推奨できるコマンドの一覧。 オブジェクトは、型 objectのすべての要素を持つ配列 (最大 3 つの要素) です。ボットがサポートするスコープごとに個別のコマンド リストを定義する必要があります。 詳細については、「ボット メニュー」を参照してください。

bots.commandLists.command

必須 – 配列

コネクタ

省略可能 – 配列

ブロックはconnectors、アプリのMicrosoft 365 グループ用のコネクタ カードを定義します。

オブジェクトは、型objectのすべての要素を持つ配列 (最大 1 つの要素) です。 このブロックは、Connector を提供するソリューションにのみ必要です。

composeExtensions

省略可能 – 配列

アプリのメッセージ拡張機能を定義します。

アイテムは、型 object のすべての要素を持つ配列 (最大 1 つの要素) です。 このブロックは、メッセージ拡張機能を提供するソリューションにのみ必要です。

composeExtensions.commands

メッセージ拡張機能では、最大 10 のコマンドで 1 つ以上のコマンドを宣言する必要があります。 各コマンドは、UI ベースのエントリ ポイントからの潜在的な相互作用として Microsoft Teams に表示されます。

各コマンド 項目は、次の構造を持つオブジェクトです。

アクセス許可

省略可能 – 文字列の配列

string の配列。これは、アプリが要求する権限を指定し、エンド ユーザーに拡張機能の機能を知らせます。 次のオプションは、非排他的です。

• identity ユーザー ID 情報が必要です。
• messageTeamMembers チーム メンバーに直接メッセージを送信するためのアクセス許可が必要です。

アプリの更新中にこれらの権限を変更すると、ユーザーは更新されたアプリを実行した後、同意プロセスを繰り返すことになります。 詳細については、「アプリの更新」を参照してください。

devicePermissions

省略可能 – 文字列の配列

アプリがアクセスを要求するユーザーのデバイスにネイティブ機能を提供します。 オプションは、次のとおりです。

• geolocation
• media
• notifications
• midi
• openExternal

validDomains

省略可能 ( 指定 されている場合は必須を除く) – 文字列の配列

アプリが Teams クライアント内にロードすることを予測する Web サイトの有効なドメインのリスト。 ドメイン リストには、*.example.com などのワイルドカードを含めることができます。 有効なドメインは、ドメインの 1 つのセグメントと正確に一致します。 a.b.example.com と一致させる必要がある場合は、*.*.example.com を使用してください。 タブ構成またはコンテンツ UI がタブ構成以外のドメインに移動する場合は、そのドメインをここで指定する必要があります。

サポートする ID プロバイダーのドメインをアプリに含めないでください。 たとえば、Google ID を使用して認証するには、accounts.google.com にリダイレクトする必要がありますが、 に validDomains[]accounts.google.com を含めてはいけません。

正常に機能するために独自の SharePoint URL を必要とする Teams アプリでは、有効なドメインリストに "{teamsitedomain}" が含まれています。

オブジェクトは、型 string のすべての要素を含む配列です。 オブジェクトの最大項目は 16 文字、最大長は 2048 文字です。

WebApplicationInfo

省略可能 – オブジェクト

ユーザーがアプリにシームレスにサインインできるように、Microsoft Entraアプリ ID と Microsoft Graph 情報を指定します。 アプリがMicrosoft Entra IDに登録されている場合は、アプリ ID を指定する必要があります。 管理者は、Teams 管理センターで権限を簡単に確認して同意を与えることができます。

graphConnector

省略可能 – オブジェクト

アプリの Graph コネクタ構成を指定します。 これが存在する場合は、 webApplicationInfo.id も指定する必要があります。

showLoadingIndicator

省略可能 – ブール値

アプリまたはタブの読み込み中に読み込みインジケーターを表示するかどうかを示します。 既定値は false です。

IsFullScreen

省略可能 – ブール値

個人用アプリがタブ ヘッダー バーなしでレンダリングされるかどうかを示します (全画面表示モードを示します)。 既定値： false

activities

省略可能 – オブジェクト

アプリがユーザー アクティビティ フィードを投稿するために使用するプロパティを定義します。

activity.activityTypes

{
   "activities":{
      "activityTypes":[
         {
            "type":"taskCreated",
            "description":"Task Created Activity",
            "templateText":"{actor} created task {taskId} for you"
         },
         {
            "type":"teamMention",
            "description":"Team Mention Activity",
            "templateText":"{actor} mentioned team"
         },
         {
            "type":"channelMention",
            "description":"Channel Mention Activity",
            "templateText":"{actor} mentioned channel"
         },
         {
            "type":"userMention",
            "description":"Personal Mention Activity",
            "templateText":"{actor} mentioned user"
         },
         {
            "type":"calendarForward",
            "description":"Forwarding a Calendar Event",
            "templateText":"{actor} sent user an invite on behalf of {eventOwner}"
         },
         {
            "type":"calendarForward",
            "description":"Forwarding a Calendar Event",
            "templateText":"{actor} sent user an invite on behalf of {eventOwner}"
         },
         {
            "type":"creatorTaskCreated",
            "description":"Created Task Created",
            "templateText":"The Creator created task {taskId} for you"
         }
      ]
   }
}

defaultInstallScope

省略可能 – 文字列

このアプリに既定で定義されているインストール スコープを指定します。 定義されたスコープは、ユーザーがアプリを追加しようとしたときにボタンに表示されるオプションです。 オプションは、次のとおりです。

• personal
• team
• groupChat
• meetings

defaultGroupCapability

省略可能 – オブジェクト

グループインストールスコープを選択すると、ユーザーがアプリをインストールするときの既定の機能が定義されます。

configurableProperties

省略可能 – 配列

configurableProperties ブロックは、チーム管理者がカスタマイズできるアプリのプロパティを定義します。 詳細については、「アプリのカスタマイズを有効にする」を参照してください。 アプリのカスタマイズ機能は、組織 (LOB アプリ) 用に構築されたカスタム アプリやカスタム アプリではサポートされていません。

次のプロパティを定義できます。

• name: アプリの表示名。
• shortDescription: アプリの簡単な説明。
• longDescription: アプリの長い説明。
• smallImageUrl: アプリのアウトライン アイコン。
• largeImageUrl: アプリの色アイコン。
• accentColor: 使用する色とアウトライン アイコンの背景。
• developerUrl: 開発者の Web サイトの HTTPS URL。
• privacyUrl: 開発者のプライバシー ポリシーの HTTPS URL。
• termsOfUseUrl: 開発者の使用条件の HTTPS URL。

supportedChannelTypes

省略可能 – 配列

非標準チャネルでアプリを有効にします。 アプリがチーム スコープをサポートしていて、このプロパティが定義されている場合、Teams ではそれに応じてそれぞれの種類のチャネルでアプリが有効になります。 supportedChannelTypes プロパティでは、 と privateChannelsのみがサポートされますsharedChannels。

defaultBlockUntilAdminAction

省略可能 – ブール値

defaultBlockUntilAdminAction プロパティ が true に 設定されている場合、管理者が許可するまで、アプリは既定でユーザーから非表示になります。 true に 設定すると、アプリは、すべてのテナントとエンド ユーザーに対して非表示になります。 テナント管理者は、Teams 管理センターでアプリを確認し、アプリを許可またはブロックするためのアクションを実行できます。 既定値は false です。 既定のアプリ ブロックの詳細については、「 管理者が承認するまでユーザーのアプリを既定でブロックする」を参照してください。

publisherDocsUrl

省略可能 – 文字列

最大サイズ - 2048 文字

パラメーターの publisherDocsUrl 値は、アプリ開発者が提供することを選択したアプリのドキュメントと情報ページへのセキュリティで保護された HTTPS URL です。 テナント管理者は、この URL でアプリに関するドキュメントを取得します。 Teams 管理センターは、アプリの詳細ページに URL を表示します。 このドキュメントには、アプリの導入とアプリのロールアウトを容易にする管理者向けの手順が含まれている場合があります。 アプリのドキュメントには、テナント管理者、ユーザー、その他のビジネス関係者に役立つアプリに関する手順や情報を含めることもできます。

subscriptionOffer

省略可能 – オブジェクト

アプリに関連付けられている SaaS オファーを指定します。

meetingExtensionDefinition

省略可能 – オブジェクト

会議拡張機能の定義を指定します。 詳細については、「Teams のカスタム Together Mode シーン」を参照してください。

meetingExtensionDefinition.scenes

承認

省略可能 – オブジェクト

アプリの承認に関する情報を指定して統合します。

authorization.permissions

authorization.permissions.resourceSpecific

RSC アプリケーションのアクセス許可

アプリケーションのアクセス許可により、アプリはサインインしたユーザーなしでデータにアクセスできます。 アプリケーションのアクセス許可の詳細については、「 Microsoft Graph と Microsoft BotSDK の RSC アクセス許可」を参照してください。

RSC 委任されたアクセス許可

委任されたアクセス許可を使用すると、アプリはサインインしているユーザーの代わりにデータにアクセスできます。

• チームの RSC 委任されたアクセス許可

  名前	説明
  ChannelMeetingParticipant.Read.Group	サインインしたユーザーの代理で、このチームに関連付けられたチャネル会議の名前、役割、ID、参加時間と退会時間などの参加者情報を読み取ることができるようにします。
  ChannelMeetingIncomingAudio.Detect.Group	アプリがチームに関連付けられているチャネル会議で受信オーディオを検出できるようにします。
  ChannelMeetingActiveSpeaker.Read.Group	アプリで、チームに関連付けられているチャネル会議にオーディオを送信している参加者を読み取ることができます。
  ChannelMeetingAudioVideo.Stream.Group	アプリがチームに関連付けられているチャネル会議からオーディオ ビデオ コンテンツをストリーミングできるようにします。
  InAppPurchase.Allow.Group	サインインしているユーザーの代わりに、アプリがチーム内のユーザーにマーケットプレース オファーを表示し、アプリ内で購入を完了できるようにします。
  ChannelMeetingStage.Write.Group	サインインしているユーザーの代わりに、チームに関連付けられているチャネル会議の会議ステージのコンテンツをアプリに表示できるようにします。
  LiveShareSession.ReadWrite.Group	アプリがチームの Live Share セッションを作成して同期し、サインインしているユーザーの代わりに、チームの名簿や関連する会議に関する名前やロールなどの関連情報にアクセスできるようにします。
  MeetingParticipantReaction.Read.Group	アプリがチームに関連付けられているチャネル会議の参加者の反応を読み取ることができます。

• チャットまたは会議の RSC 委任されたアクセス許可

  名前	説明
  InAppPurchase.Allow.Chat	アプリがチャット内のユーザーと関連する会議に Marketplace オファーを表示し、サインインしているユーザーに代わってアプリ内で購入を完了できるようにします。
  MeetingStage.Write.Chat	アプリで、サインインしているユーザーの代わりに、チャットに関連付けられている会議の会議ステージのコンテンツを表示できるようにします。
  OnlineMeetingParticipant.Read.Chat	アプリは、サインインしているユーザーの代わりに、チャットに関連付けられている会議の名前、ロール、ID、参加済み、および退席時刻などの参加者情報を読み取ることができます。
  OnlineMeetingParticipant.ToggleIncomingAudio.Chat	アプリで、サインインしているユーザーの代わりに、チャットに関連付けられている会議の参加者の受信オーディオを切り替えることができます。
  LiveShareSession.ReadWrite.Chat	アプリがチャットの Live Share セッションを作成および同期し、サインインしているユーザーの代わりに、チャットの名簿や関連する会議に関する名前やロールなどの関連情報にアクセスできるようにします。
  MeetingParticipantReaction.Read.Chat	アプリがチャットに関連付けられている会議の参加者の反応を読み取ることができます。
  OnlineMeetingIncomingAudio.Detect.Chat	サインインしているユーザーの代わりに、チャットに関連付けられている会議での受信オーディオの状態の変更をアプリで検出できるようにします。
  OnlineMeetingActiveSpeaker.Read.Chat	アプリで、チャットに関連付けられている会議に音声を送信している参加者を読み取ることができます。
  OnlineMeetingAudioVideo.Stream.Chat	アプリがチャットに関連付けられている会議のオーディオ ビデオ コンテンツをストリーミングできるようにします。

• ユーザーの RSC 委任されたアクセス許可

  名前	説明
  CameraStream.Read.User	アプリがユーザーのカメラ ストリームを読み取ることができます。
  InAppPurchase.Allow.User	サインインしているユーザーの代わりに、アプリでユーザー マーケットプレース オファーを表示し、アプリ内でユーザーの購入を完了できるようにします。
  OutgoingVideoStream.Write.User	アプリがユーザーの送信ビデオを変更できるようにします。
  MicrophoneStream.Read.User	アプリがユーザーのマイク ストリームを読み取ることができます。
  MeetingParticipantReaction.Read.User	アプリが会議に参加している間にユーザーの反応を読み取ることができます。

extensions

省略可能 – オブジェクト

プロパティは extensions 、アプリ マニフェスト内の Outlook アドインを指定し、Microsoft 365 エコシステム全体での配布と取得を簡略化します。 各アプリでは、1 つの拡張機能のみがサポートされます。

詳細については、「 Microsoft 365 用 Office アドイン マニフェスト」を参照してください。

extensions.requirements

オブジェクトは extensions.requirements 、アドインをインストールするために Office クライアントでサポートする必要があるスコープ、フォーム ファクター、および Office JavaScript ライブラリ要件セットを指定します。 要件は、アドインの一部の機能を選択的に除外するための "リボン"、"ランタイム"、"代替"、および "autoRunEvents" 子プロパティでもサポートされています。 詳細については、「 Microsoft 365 の統合マニフェストで Office アドインの要件を指定する」を参照してください。

extensions.runtimes

省略可能 – 配列

配列は extensions.runtimes 、各拡張ポイントで使用できるランタイムとアクションのセットを構成します。

を使用 extensions.runtimesするには、「 アドイン コマンドの作成」を参照し、 作業ウィンドウのランタイムを構成し、 関数コマンドのランタイムを構成します。

extensions.ribbons

省略可能 – 配列

プロパティを extensions.ribbons 使用すると、 アドイン コマンド (ボタンとメニュー項目) を Microsoft 365 アプリケーションのリボンに追加できます。 リボン定義は、要件と最初の順序に基づいて配列から選択されます。

を使用 extensions.ribbonsするには、「 アドイン コマンドの作成」を参照し、 作業ウィンドウ コマンドの UI を構成し、 関数コマンドの UI を構成します。

extensions.autoRunEvents

省略可能 – 配列

プロパティは extensions.autoRunEvents 、イベント ベースのアクティブ化拡張ポイントを定義します。

extensions.alternates

省略可能 – 配列

プロパティは extensions.alternates 、機能が重複する複数のアドインを発行した場合に、特定の市場内アドインを非表示または優先順位付けするために使用されます。

dashboardCards

省略可能 – 配列

アプリ情報の概要ビューを提供するために、Microsoft Viva Connectionsなどのダッシュボードにピン留めできるカードの一覧を定義します。 Viva Connections ダッシュボードのカードの作成の詳細については、「Bot Powered Adaptive Card Extensions の概要」を参照してください。

この項目は、 型の要素の dashboardCard 配列です object。

dashboardCards.dashboardCard

1 つのダッシュボード カードとそのプロパティを定義します。

dashboardCards.dashboardCard.icon

特定のダッシュボード カードのアイコン プロパティを定義します。

dashboardCards.dashboardCard.contentSource

特定のダッシュボード カードのコンテンツ ソースを定義します。

dashboardCards.dashboardCard.contentSource.botConfiguration

アプリ マニフェスト ファイルを作成する

アプリにアプリ マニフェスト ファイルがない場合は、作成する必要があります。

アプリ マニフェスト ファイルを作成するには:

1. サンプル アプリ マニフェスト スキーマを使用して、.json ファイルを作成します。
2. これをプロジェクト フォルダーのルートに、manifest.jsonとして保存します。

{ 
"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.11/MicrosoftTeams.schema.json", 
"manifestVersion": "1.12", 
"version": "1.0.0", 
"id": "{new GUID for this Teams app - not the Microsoft Entra App ID}", 
"developer": { 
"name": "Microsoft", 
"websiteUrl": "https://www.microsoft.com", 
"privacyUrl": "https://www.microsoft.com/privacy", 
"termsOfUseUrl": "https://www.microsoft.com/termsofuse" 
}, 

"name": { 
  "short": "Teams Auth SSO", 
  "full": "Teams Auth SSO" 
}, 


"description": { 
  "short": "Teams Auth SSO app", 
  "full": "The Teams Auth SSO app" 
}, 

"icons": { 
  "outline": "outline.png", 
  "color": "color.png" 
}, 

"accentColor": "#60A18E", 
"staticTabs": [ 
  { 
   "entityId": "auth", 
   "name": "Auth", 
   "contentUrl": "https://subdomain.example.com/Home/Index", 
   "scopes": [ "personal" ] 
  } 
], 

"configurableTabs": [ 
  { 
   "configurationUrl": "https://subdomain.example.com/Home/Configure", 
   "canUpdateConfiguration": true, 
   "scopes": [ 
   "team" 
    ] 
  } 
], 
"permissions": [ "identity", "messageTeamMembers" ], 
"validDomains": [ 
 "{subdomain or ngrok url}" 
], 
"webApplicationInfo": { 
  "id": "{Microsoft Entra AppId}", 
  "resource": "api://subdomain.example.com/{Microsoft Entra AppId}" 
}
} 

関連項目

• Microsoft Teams アプリの構造を理解する
• アプリのカスタマイズを有効にする
• アプリをローカライズする
• メディア機能を統合する
• パブリック開発者プレビュー アプリ マニフェスト スキーマ