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

  • [アーティクル]

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

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

注:

共有チャネルのタブ アプリは、 Government Community Cloud (GCC)、GCC-High、および国防総省 (DOD) 環境で使用できます。

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

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

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

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

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

注:

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

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

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

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

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

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

注:

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

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

を使用し、次の手順に従って、直接共有チャネル メンバーシップをhostTeamGroupIDgetContext取得できます。

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

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

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

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

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

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

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

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

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

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

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

Azure AD ネイティブ ID

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

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

関連項目