Microsoft Teams共有チャネルを接続する

  • [アーティクル]

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

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

注:

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

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

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

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

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

注:

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

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

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

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

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

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

注:

アクティビティ フィード通知 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 プロパティと比較します。

Microsoft Entra ネイティブ ID

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

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

関連項目