次の方法で共有

共有チャネルをMicrosoft Teams Connectする

Microsoft Teams Connect共有チャネルを使用すると、チャネルのメンバーが他のチームや組織のユーザーと共同作業できるようになります。 共有チャネルは、次のように作成して共有できます。

  • 同じorganization内の別のチームのメンバー。
  • 同じorganization内の個人。
  • 個人および他の組織の他のチーム。

注:

Teams Connect共有チャネルは、安全なコラボレーションをシームレスに促進します。 ユーザー コンテキストを変更せずに、organization外の外部ユーザーが Teams の内部ユーザーと共同作業できるようにします。 たとえば、ゲスト アカウントの使用とは異なり、ユーザー エクスペリエンスを強化します。たとえば、メンバーは Teams からサインアウトし、ゲスト アカウントを使用して再びサインインする必要があります。 Teams アプリケーションは、強力なコラボレーション 領域を拡張します。

図は、organization A のチーム B と、チーム A として共有チャネルで共同作業しているorganization B のチーム C を示しています。

共有チャネルに対してアプリを有効にする

SupportedChannelTypes は、標準以外のチャネルでアプリを有効にする省略可能なプロパティです。 アプリがチーム スコープをサポートし、プロパティが定義されている場合、Teams では、それに応じて各チャネルの種類でアプリが有効になります。 プライベート チャネルと共有チャネルがサポートされています。 詳細については、「 supportedChannelTypes」を参照してください。

    "supportedChannelTypes": [
        "sharedChannels",
        "privateChannels"
    ]

注:

  • アプリがチーム スコープをサポートしている場合、このプロパティで定義されている値に関係なく、アプリは標準チャネルで機能します。
  • アプリが適切に機能するためには、これらの各チャネルの種類の一意のプロパティを考慮する必要がある場合があります。

共有チャネルのコンテキストを取得する

コンテンツ UX が共有チャネルに読み込まれる場合は、共有チャネルの変更 getContext 呼び出しから受信したデータを使用します。 getContext 呼び出しでは、Microsoft Graph API を使用してチャネル メンバーシップを取得するために使用される、 hostTeamGroupID と hostTenantID の 2 つの新しいプロパティが発行されます。 hostTeam は、共有チャネルを作成するチームです。

タブを有効にする方法の詳細については、次を参照してください。

共有チャネルのアプリとアクセス許可

共有チャネルを使用して、organization外の外部メンバーと共同作業できます。 共有チャネルのアプリのアクセス許可は、ホスト チームのアプリ名簿とホスト テナントのアプリ ポリシーに従います。

注:

アクティビティ フィード通知 API では、共有チャネル内のアプリのテナント間通知はサポートされていません。

共有チャネル メンバーシップを取得する

直接共有チャネル メンバーシップを取得するには、getContextからhostTeamGroupIDを使用し、次の手順に従います。

  1. GET チャネル メンバー API API を使用して直接メンバーを取得します。

    GET /teams/{host-team-group-id}/channels/{channel-id}/members

  2. GET sharedWithTeams API を使用して各共有チームを取得します。

    GET /teams/{host-team-group-id}/channels/{channel-id}/sharedWithTeams

  3. GET sharedWithTeams API を使用して、各共有チーム (チーム X) の GET メンバーを使用します。

    GET /teams/{host-team-group-id}/channels/{channel-id}/sharedWithTeams/{teamX}/members

共有チャネルのメンバーをテナント内またはテナント外として分類する

メンバーまたはチームの tenantID を次のように hostTeamTenantID と比較することで、メンバーをテナント内またはテナント外として分類できます。

  1. 比較するメンバーを取得します。

    GET /teams/{host-team-group-id}/channels/{channel-id}/members

  2. getContextを使用し、メンバーのtenantIDを hostTenantID プロパティと比較します。

ネイティブ ID のMicrosoft Entra

アプリは、インストールと使用状況でテナント間で機能する必要があります。 次の表に、チャネルの種類とそれに対応するグループ ID を示します。

チャネルの種類 groupId hostTeamGroupId
Regular チーム Microsoft Entra グループ ID チーム Microsoft Entra グループ ID
共有 Empty ホスト チーム Microsoft Entra グループ ID

フェデレーション グループ内のアプリが外部ユーザーとチャットする

注:

Teams では、外部ユーザーとのフェデレーション グループ チャットでのアプリの使用がサポートされています。 これらのユーザーは、グループ チャットからアプリを追加、更新、または削除することはできません。 アプリを追加、更新、または削除できるのは、グループ チャットのホストのみです。 ただし、チャットのすべてのメンバー (外部ユーザーを含む) は、次の条件でアプリを使用できます。

  • グループ チャット ホストのorganizationのテナント管理者と外部ユーザーのorganizationのテナント管理者は、フェデレーション グループ チャットでのアプリの使用を許可する必要があります。 詳細については、「外部の出席者またはorganizationの外部からのゲスト用の Teams アプリ」を参照してください。
  • アプリは、フェデレーション グループ チャットの外部ユーザーへのアクセスを許可します。

外部ユーザーとのフェデレーション グループ チャットで使用するアプリを開発している場合は、Microsoft Entra IDでマルチテナント アプリとしてアプリを登録します。 このアクションを使用すると、複数の組織のユーザーがアプリにアクセスできます。

注:

フェデレーション グループ チャットで外部ユーザーと 共にコード サンプル をテストする場合は、まず外部ユーザーをゲストとしてテナントに追加する必要があります。 詳細については、「 クイック スタート: ゲスト ユーザーを追加して招待を送信する」を参照してください。 ユーザーをテナントに追加した後、フェデレーション グループ チャットに移動し、ゲストを追加してアプリをテストします。

コード サンプル

サンプルの名前 説明 Node.js
Teams 会話ボット このサンプル アプリは、外部ユーザーとのフェデレーション グループ チャットのメンバーの名前を表示します。 表示

関連項目