Поделиться через

Общие каналы Microsoft Teams Connect

  • Статья

Общие каналы Microsoft Teams Connect позволяют участникам канала сотрудничать с пользователями в других командах и организациях. Вы можете создать общий канал и предоставить общий доступ к ним:

  • Члены другой команды в той же организации.
  • Пользователи в одной организации.
  • Частные лица и другие команды других организаций.

Примечание.

Приложения tab в общих каналах доступны в средах Сообщества государственных организаций (GCC), GCC-High и Министерства обороны (DOD).

Общие каналы Teams Connect упрощают безопасную совместную работу. Разрешить внешним пользователям за пределами организации работать с внутренними пользователями в Teams без изменения их контекста пользователей. Улучшение взаимодействия с пользователем в отличие от использования гостевых учетных записей, например, участники должны выйти из Teams и снова войти с помощью гостевой учетной записи. Приложения Teams расширяют возможности совместной работы.

Схема: команда B из организации A и команда C из организации B, совместная работающая в общем канале как команда A.

Включение приложения для общих каналов

SupportedChannelTypes — это необязательное свойство, которое позволяет приложению использовать нестандартные каналы. Если приложение поддерживает область команды и свойство определено, Teams включает приложение в каждом типе канала соответствующим образом. Поддерживаются частные и общие каналы. Дополнительные сведения см. в разделе SupportedChannelTypes.

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

Примечание.

  • Если приложение поддерживает область команды, оно работает в стандартных каналах, независимо от того, какие значения определены в этом свойстве.
  • Чтобы правильно функционировать, приложению может потребоваться учет уникальных свойств каждого из этих типов каналов.

Получение контекста для общих каналов

При загрузке пользовательского интерфейса содержимого в общий канал используйте данные, полученные из getContext вызова, для изменения общего канала. getContext при вызове публикуются два новых свойства и hostTeamGroupIDhostTenantID, которые используются для получения членства в канале с помощью API Microsoft Graph. hostTeam — это команда, создающая общий канал.

Дополнительные сведения о включении вкладки см. в разделе:

Приложения и разрешения в общих каналах

Вы можете работать с внешними участниками за пределами организации с помощью общих каналов. Разрешения приложений в общих каналах соответствуют списку приложений команды узла и политике приложений клиента узла.

Примечание.

API уведомлений веб-канала действий не поддерживает уведомления между арендаторами для приложений в общем канале.

Получение членства в общем канале

Вы можете получить прямое членство в общем канале hostTeamGroupID с помощью и getContext выполните следующие действия:

  1. Получите прямых участников с помощью API API членов канала GET .

    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 членов каждой общей команды (Team X) с ПОМОЩЬЮ API GET sharedWithTeams .

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

Классифицируйте члены в общем канале как в клиенте или в out-tenant

Члены можно классифицировать как в клиенте или out-tenant путем сравнения tenantID участника или команды следующим hostTeamTenantID образом:

  1. Получите элемент, который вы хотите сравнить.

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

  2. Используйте getContext, сравните tenantID элемент со свойством hostTenantID .

Собственное удостоверение Microsoft Entra

Приложения должны работать между арендаторами при установке и использовании. В следующей таблице перечислены типы каналов и соответствующие им идентификаторы групп:

Тип канала groupId hostTeamGroupId
Regular Командный идентификатор группы Microsoft Entra Командный идентификатор группы Microsoft Entra
Shared переменная Empty Идентификатор группы узлов Microsoft Entra

См. также