Microsoft Teams Связи общих каналов
Microsoft Teams Связи общих каналов позволяют участникам канала сотрудничать с пользователями в других командах и организациях. Вы можете создать общий канал и предоставить общий доступ к ним:
- Члены другой команды в той же организации.
- Пользователи в одной организации.
- Частные лица и другие команды других организаций.
Примечание.
- Приложения tab в общих каналах доступны в средах Сообщества государственных организаций (GCC), GCC-High и Министерства обороны (DOD).
- Приложения SharePoint и страниц SharePoint не поддерживаются для общих каналов в средах GCC, GCC-High и DOD.
Teams Связи общих каналов обеспечивают безопасную совместную работу. Разрешить внешним пользователям за пределами организации работать с внутренними пользователями в Teams без изменения их контекста пользователей. Улучшение взаимодействия с пользователем в отличие от использования гостевых учетных записей, например, участники должны выйти из Teams и снова войти с помощью гостевой учетной записи. Приложения Teams расширяют возможности совместной работы.
Включение приложения для общих каналов
SupportedChannelTypes — это необязательное свойство, которое позволяет приложению использовать нестандартные каналы. Если приложение поддерживает командную область и свойство определено, Teams включает приложение в каждом типе канала соответствующим образом. Поддерживаются частные и общие каналы. Дополнительные сведения см. в разделе SupportedChannelTypes.
"supportedChannelTypes": [
"sharedChannels",
"privateChannels"
]
Примечание.
- Если приложение поддерживает командные область, оно работает в стандартных каналах, независимо от того, какие значения определены в этом свойстве.
- Чтобы правильно функционировать, приложению может потребоваться учет уникальных свойств каждого из этих типов каналов.
Получение контекста для общих каналов
При загрузке пользовательского интерфейса содержимого в общий канал используйте данные, полученные из getContext
вызова, для изменения общего канала.
getContext
при вызове публикуются два новых свойства и hostTeamGroupID
hostTenantID
, которые используются для получения членства в канале с помощью API Microsoft Graph.
hostTeam
— это команда, создающая общий канал.
Дополнительные сведения о включении вкладки см. в разделе:
Приложения и разрешения в общих каналах
Вы можете работать с внешними участниками за пределами организации с помощью общих каналов. Разрешения приложений в общих каналах соответствуют списку приложений команды узла и политике приложений клиента узла.
Примечание.
API уведомлений веб-канала действий не поддерживает уведомления между арендаторами для приложений в общем канале.
Получение членства в общем канале
Вы можете получить прямое членство в общем канале hostTeamGroupID
с помощью и getContext
выполните следующие действия:
Получите прямых участников с помощью API API членов канала GET .
GET /teams/{host-team-group-id}/channels/{channel-id}/members
Получение каждой общей команды с помощью GET
sharedWithTeams
API.GET /teams/{host-team-group-id}/channels/{channel-id}/sharedWithTeams
Используйте GET членов каждой общей команды (Team X) с ПОМОЩЬЮ API GET
sharedWithTeams
.GET /teams/{host-team-group-id}/channels/{channel-id}/sharedWithTeams/{teamX}/members
Классифицируйте члены в общем канале как в клиенте или в out-tenant
Члены можно классифицировать как в клиенте или out-tenant путем сравнения tenantID
участника или команды следующим hostTeamTenantID
образом:
Получите элемент, который вы хотите сравнить.
GET /teams/{host-team-group-id}/channels/{channel-id}/members
Используйте
getContext
, сравнитеtenantID
элемент со свойствомhostTenantID
.
Microsoft Entra собственное удостоверение
Приложения должны работать между арендаторами при установке и использовании. В следующей таблице перечислены типы каналов и соответствующие им идентификаторы групп:
Тип канала | groupId | hostTeamGroupId |
---|---|---|
Regular | Идентификатор группы Microsoft Entra команды | Идентификатор группы Microsoft Entra команды |
Shared | переменная Empty | Идентификатор группы Microsoft Entra хост-команды |
См. также
Platform Docs