Freigeben über

Freigegebene Microsoft Teams Connect-Kanäle

  • Artikel

Über freigegebene Microsoft Teams Connect-Kanäle können Mitglieder eines Kanals mit Benutzern in anderen Teams und Organisationen zusammenarbeiten. Sie können einen freigegebenen Kanal erstellen und freigeben mit:

  • Mitglieder eines anderen Teams innerhalb derselben Organisation.
  • Einzelpersonen innerhalb derselben Organisation.
  • Einzelpersonen und andere Teams anderer Organisationen.

Hinweis

Freigegebene Teams Connect-Kanäle ermöglichen eine nahtlose sichere Zusammenarbeit. Ermöglichen Sie externen Benutzern außerhalb Ihrer Organisation, mit internen Benutzern in Teams zusammenzuarbeiten, 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 aus Organisation A und Team C aus Organisation 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 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 Organisation ü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.

Native Microsoft Entra-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 Hostteam Microsoft Entra-Gruppen-ID

Siehe auch