Microsoft Teams Connect freigegebener Kanäle

  • Artikel

Microsoft Teams Connect freigegebenen Kanälen ermöglichen es Mitgliedern eines Kanals, mit Benutzern in anderen Teams und Organisationen zusammenzuarbeiten. Sie können einen freigegebenen Kanal erstellen und freigeben mit:

  • Mitglieder eines anderen Teams innerhalb desselben organization.
  • Einzelpersonen innerhalb desselben organization.
  • Einzelpersonen und andere Teams anderer Organisationen.

Hinweis

Registerkarten-Apps in freigegebenen Kanälen sind in Umgebungen für Government Community Cloud (GCC), GCC-High und Department of Defense (DOD) verfügbar.

Teams Connect freigegebenen Kanälen ermöglichen eine nahtlose sichere Zusammenarbeit. Ermöglichen Sie externen Benutzern außerhalb Ihrer organization die Zusammenarbeit mit internen Benutzern in Teams, ohne ihren Benutzerkontext zu ändern. Verbessern Sie die Benutzererfahrung im Gegensatz zur Verwendung von Gastkonten, z. B. müssen sich die Mitglieder von Teams abmelden und sich erneut mit einem Gastkonto anmelden. Teams-Anwendungen erweitern den leistungsstarken Bereich für die Zusammenarbeit.

Diagramm, das Team B von organization A und Team C aus organization B zeigt, die in einem freigegebenen Kanal als Team A zusammenarbeiten.

Aktivieren Ihrer App für freigegebene Kanäle

SupportedChannelTypes ist eine optionale Eigenschaft, die Ihre App in nicht standardmäßigen Kanälen aktiviert. Wenn Ihre App den Teambereich unterstützt und die -Eigenschaft definiert ist, aktiviert Teams Ihre App in jedem Kanaltyp entsprechend. Private und freigegebene Kanäle werden derzeit unterstützt. Weitere Informationen finden Sie unter supportedChannelTypes.

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

Hinweis

  • Wenn Ihre App den Teambereich unterstützt, funktioniert sie in Standardkanälen, unabhängig davon, welche Werte in dieser Eigenschaft definiert sind.
  • Ihre App muss möglicherweise die eindeutigen Eigenschaften der einzelnen Kanaltypen berücksichtigen, damit sie ordnungsgemäß funktioniert.

Abrufen des Kontexts für freigegebene Kanäle

Wenn die Inhalts-UX in einem freigegebenen Kanal geladen wird, verwenden Sie die vom Aufruf empfangenen Daten für Änderungen am getContext freigegebenen Kanal. getContext -Aufruf veröffentlicht zwei neue Eigenschaften, hostTeamGroupID und hostTenantID, die zum Abrufen der Kanalmitgliedschaft mithilfe von Microsoft Graph-APIs verwendet werden. hostTeam ist das Team, das den freigegebenen Kanal erstellt.

Weitere Informationen zum Aktivieren der Registerkarte finden Sie unter:

Apps und Berechtigungen in freigegebenen Kanälen

Sie können mit externen Mitgliedern außerhalb Ihrer organization über freigegebene Kanäle zusammenarbeiten. App-Berechtigungen in freigegebenen Kanälen folgen der App-Liste des Hostteams und der App-Richtlinie des Hostmandanten.

Hinweis

Die Benachrichtigungs-API für Aktivitätsfeeds unterstützt keine mandantenübergreifenden Benachrichtigungen für Apps in einem freigegebenen Kanal.

Abrufen der Mitgliedschaft im freigegebenen Kanal

Sie können eine direkte Mitgliedschaft im freigegebenen Kanal erhalten, indem Sie von hostTeamGroupIDgetContext verwenden und die folgenden Schritte ausführen:

  1. Rufen Sie direkte Mitglieder mit der API für GET-Kanalmitglieder ab .

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

  2. Rufen Sie jedes freigegebene Team mit der GET-API sharedWithTeams ab.

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

  3. Verwenden Sie GET-Mitglieder jedes freigegebenen Teams (Team X) mit der GET-API sharedWithTeams .

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

Klassifizieren von Mitgliedern im freigegebenen Kanal als mandantenintern oder out-tenant

Sie können Mitglieder als mandantenintern oder out-tenant klassifizieren, indem Sie das Mitglied oder Team wie hostTeamTenantID folgt vergleichentenantID:

  1. Rufen Sie das Mitglied ab, das Sie vergleichen möchten.

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

  2. Verwenden Sie , vergleichen Sie getContextden tenantID des Members mit der hostTenantID -Eigenschaft.

Microsoft Entra native Identität

Apps müssen bei der Installation und Verwendung mandantenübergreifend funktionieren. In der folgenden Tabelle sind die Kanaltypen und die entsprechenden Gruppen-IDs aufgeführt:

Kanaltyp groupId hostTeamGroupId
Regular Team Microsoft Entra Gruppen-ID Team Microsoft Entra Gruppen-ID
Shared Empty Gruppen-ID des Hostteams Microsoft Entra

Siehe auch