共有チャネルをMicrosoft Teams Connectする
Microsoft Teams Connect共有チャネルを使用すると、チャネルのメンバーが他のチームや組織のユーザーと共同作業できるようになります。 共有チャネルは、次のように作成して共有できます。
- 同じorganization内の別のチームのメンバー。
- 同じorganization内の個人。
- 個人および他の組織の他のチーム。
注:
- 共有チャネルのタブ アプリは、 Government Community Cloud (GCC)、GCC High、国防総省 (DoD)、 21Vianet 環境が運営する Teams で 利用できます。
- SharePoint および SharePoint ページ アプリは、21Vianet 環境によって運営される GCC、GCC High、DoD、および Teams の共有チャネルではサポートされていません。
Teams Connect共有チャネルは、安全なコラボレーションをシームレスに促進します。 ユーザー コンテキストを変更せずに、organization外の外部ユーザーが Teams の内部ユーザーと共同作業できるようにします。 たとえば、ゲスト アカウントの使用とは異なり、ユーザー エクスペリエンスを強化します。たとえば、メンバーは Teams からサインアウトし、ゲスト アカウントを使用して再びサインインする必要があります。 Teams アプリケーションは、強力なコラボレーション 領域を拡張します。
共有チャネルに対してアプリを有効にする
SupportedChannelTypes は、標準以外のチャネルでアプリを有効にする省略可能なプロパティです。 アプリがチーム スコープをサポートし、プロパティが定義されている場合、Teams では、それに応じて各チャネルの種類でアプリが有効になります。 プライベート チャネルと共有チャネルがサポートされています。 詳細については、「 supportedChannelTypes」を参照してください。
"supportedChannelTypes": [
"sharedChannels",
"privateChannels"
]
注:
- アプリがチーム スコープをサポートしている場合、このプロパティで定義されている値に関係なく、アプリは標準チャネルで機能します。
- アプリが適切に機能するためには、これらの各チャネルの種類の一意のプロパティを考慮する必要がある場合があります。
共有チャネルのコンテキストを取得する
コンテンツ UX が共有チャネルに読み込まれる場合は、共有チャネルの変更 getContext
呼び出しから受信したデータを使用します。
getContext
呼び出しでは、Microsoft Graph API を使用してチャネル メンバーシップを取得するために使用される、 hostTeamGroupID
と hostTenantID
の 2 つの新しいプロパティが発行されます。
hostTeam
は、共有チャネルを作成するチームです。
タブを有効にする方法の詳細については、次を参照してください。
共有チャネルのアプリとアクセス許可
共有チャネルを使用して、organization外の外部メンバーと共同作業できます。 共有チャネルのアプリのアクセス許可は、ホスト チームのアプリ名簿とホスト テナントのアプリ ポリシーに従います。
注:
アクティビティ フィード通知 API では、共有チャネル内のアプリのテナント間通知はサポートされていません。
共有チャネル メンバーシップを取得する
直接共有チャネル メンバーシップを取得するには、getContext
からhostTeamGroupID
を使用し、次の手順に従います。
GET チャネル メンバー API API を使用して直接メンバーを取得します。
GET /teams/{host-team-group-id}/channels/{channel-id}/members
GET
sharedWithTeams
API を使用して各共有チームを取得します。GET /teams/{host-team-group-id}/channels/{channel-id}/sharedWithTeams
GET
sharedWithTeams
API を使用して、各共有チーム (チーム X) の GET メンバーを使用します。GET /teams/{host-team-group-id}/channels/{channel-id}/sharedWithTeams/{teamX}/members
共有チャネルのメンバーをテナント内またはテナント外として分類する
メンバーまたはチームの tenantID
を次のように hostTeamTenantID
と比較することで、メンバーをテナント内またはテナント外として分類できます。
比較するメンバーを取得します。
GET /teams/{host-team-group-id}/channels/{channel-id}/members
getContext
を使用し、メンバーのtenantID
をhostTenantID
プロパティと比較します。
ネイティブ ID のMicrosoft Entra
アプリは、インストールと使用状況でテナント間で機能する必要があります。 次の表に、チャネルの種類とそれに対応するグループ ID を示します。
チャネルの種類 | groupId | hostTeamGroupId |
---|---|---|
Regular | チーム Microsoft Entra グループ ID | チーム Microsoft Entra グループ ID |
共有 | Empty | ホスト チーム Microsoft Entra グループ ID |
関連項目
Platform Docs