Suche

Microsoft Graph API /teams-channels-members

Themen

Mitglieder in Microsoft Teams Kanälen verwalten

Die Microsoft Graph API Teams Mitglieder über den Endpunkt /teams/{team-id}/channels/{channel-id}/members ermöglicht das Abrufen, Hinzufügen und Entfernen von Mitgliedern in Teams-Kanälen. HTTP-Methoden wie GET, POST und DELETE unterstützen die REST‑basierte Verwaltung von Team-Zugriffen.

Was kann der „/members“-Endpunkt?

Der Endpunkt /teams/{team-id}/channels/{channel-id}/members gibt dir den kompletten Zugriff auf die Mitglieder eines bestimmten Kanals in Microsoft Teams.

Über diesen Endpunkt kannst du:

  • Alle Mitglieder eines Kanals abrufen
  • Details zu einzelnen Mitgliedern abfragen
  • Neue Mitglieder zu einem Kanal hinzufügen (z.B. für private Kanäle oder Shared Channels)
  • Bestehende Mitglieder aus einem Kanal entfernen

Das ist vor allem für private und Shared Channels super wichtig, weil dort die Mitgliedschaften vom Team abweichen können.

Der „/members“-Endpunkt der Microsoft Graph API ist ein echter Geheimtipp für alle, die Microsoft Teams in Power Platform-Prozesse einbinden wollen.

Gerade bei Projekten, Onboarding-Prozessen oder Self-Service-Apps sorgt dieser Endpunkt dafür, dass die richtigen Personen automatisch in die richtigen Kanäle kommen – ohne nervige manuelle Nacharbeit.

Mein Tipp: Wenn du Power Apps oder Power Automate in Kombination mit Teams nutzt, solltest du den „/members“-Endpunkt auf jeden Fall auf dem Schirm haben. Er macht deine Apps smarter, flexibler und vor allem: komplett automatisiert.

/teams/{Id}/channel/{id}/members

 

GET

Mit dem Microsoft Graph Endpunkt GET /teams/{team-id}/channels/{channel-id}/members kannst du alle Mitglieder eines privaten Microsoft Teams-Kanals abrufen. Du bekommst eine vollständige Liste der Mitglieder inklusive deren IDs, Rollen und weiteren Details. Perfekt, um in Power Automate oder Power Apps die Kanal-Mitglieder anzuzeigen oder mit diesen Daten automatisierte Prozesse zu steuern. Der Endpunkt liefert die Informationen im JSON-Format, wodurch du sie direkt in deine Low-Code-Lösungen integrieren kannst. Ideal für Membership-Management, Zugriffsprüfungen oder um Teams-Strukturen sauber zu dokumentieren und transparent zu halten!

Power Apps

'HTTPwithMicrosoftEntraID(preauthorized)'.InvokeHttp(
    "GET",
    With(
        {
            teamsId: "bccd65d2-b391-4044-b043-838bbca82af7",
            channelId: "19:2212cfd4ecc640ffae283fb1da9fafcf@thread.tacv2"
        },
        $"https://graph.microsoft.com/beta/teams/{teamsId}/channels/{channelId}/members"
    )
)

POST

Mit dem Microsoft Graph Endpunkt POST /teams/{team-id}/channels/{channel-id}/members kannst du Mitglieder zu einem privaten Kanal in Microsoft Teams hinzufügen. Du gibst in der Anfrage die User-ID des Mitglieds sowie dessen Rolle an, also ob der Nutzer ein normales Mitglied oder Besitzer sein soll. Dieser Endpunkt ist ideal, wenn du in Power Automate oder Power Apps automatisiert Nutzer zu Kanälen hinzufügen möchtest, etwa bei neuen Projekten oder Teams. Die Antwort enthält Details zum hinzugefügten Mitglied, etwa die Mitgliedschafts-ID und Rolle. Besonders praktisch, um dynamische Teams-Strukturen oder automatische Onboarding-Prozesse aufzubauen!

Power Apps

'HTTPwithMicrosoftEntraID(preauthorized)'.InvokeHttp(
    "POST",
    With(
        {
            teamsId: "bccd65d2-b391-4044-b043-838bbca82af7",
            channelId: "19:2212cfd4ecc640ffae283fb1da9fafcf@thread.tacv2"
        },
        $"https://graph.microsoft.com/beta/teams/{teamsId}/channels/{channelId}/members"
    ),
    {
        body: JSON(
            {
                '@odata.type': "#microsoft.graph.aadUserConversationMember",
                roles: [],
                'user@odata.bind': $"https://graph.microsoft.com/v1.0/users('{Office365Users.UserProfileV2("KlickiCarla@LowCoder.com").id}')"
            }
        )
    }
)

/teams/{Id}/channel/{id}/members/{id}

 

GET

Mit dem Microsoft Graph Endpunkt GET /teams/{team-id}/channels/{channel-id}/members/{membership-id} kannst du gezielt ein einzelnes Mitglied in einem Microsoft Teams-Kanal abfragen. Du erhältst Infos wie den Anzeigenamen, die ID und die Rolle des Users im Kanal, also ob er Mitglied oder Besitzer ist. Perfekt, wenn du in Power Automate oder Power Apps eine Überprüfung durchführen möchtest, etwa um sicherzustellen, dass ein bestimmter User die richtige Rolle hat. Die Antwort kommt als JSON und lässt sich super in automatisierte Prozesse integrieren, zum Beispiel für Benachrichtigungen oder Berechtigungsprüfungen. Einfach, schnell und effektiv!

Power Apps

'HTTPwithMicrosoftEntraID(preauthorized)'.InvokeHttp(
    "GET",
    With(
        {
            teamsId: "bccd65d2-b391-4044-b043-838bbca82af7",
            channelId: "19:2212cfd4ecc640ffae283fb1da9fafcf@thread.tacv2",
            membersId: "MCMjMiMjYWQ5MmY3NzYtNjk5NC00YWQ0LTgzYTItYzU1MTllYzQ4ZDE3IyMxOToyMjEyY2ZkNGVjYzY0MGZmYWUyODNmYjFkYTlmYWZjZkB0aHJlYWQudGFjdjIjIzcwMDdlYzNkLWVkMDEtNGNlZS05ZWEyLTM3YTgwYTdlMGIwOQ=="
        },
        $"https://graph.microsoft.com/beta/teams/{teamsId}/channels/{channelId}/members/{membersId}"
    )
)

PATCH

Der Endpunkt PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id} wird genutzt, um die Rolle eines Mitglieds in einem bestimmten Microsoft Teams-Kanal zu ändern. Damit kannst du z.B. festlegen, ob jemand Besitzer oder einfaches Mitglied im Kanal ist. In der Anfrage gibst du die entsprechende Mitgliedschaft-ID an und definierst im Body die neue Rolle. Das ist ideal, um in Power Automate oder Power Apps gezielt Kanal-Mitgliedschaften zu verwalten und Rollen automatisiert zu steuern. Die Antwort enthält die aktualisierten Mitgliedsdaten des Kanals im JSON-Format. Praktisch für Membership-Management in Teams!

Power Apps

'HTTPwithMicrosoftEntraID(preauthorized)'.InvokeHttp(
    "PATCH",
    With(
        {
            teamsId: "bccd65d2-b391-4044-b043-838bbca82af7",
            channelId: "19:2212cfd4ecc640ffae283fb1da9fafcf@thread.tacv2",
            membersId: "MCMjMiMjYWQ5MmY3NzYtNjk5NC00YWQ0LTgzYTItYzU1MTllYzQ4ZDE3IyMxOToyMjEyY2ZkNGVjYzY0MGZmYWUyODNmYjFkYTlmYWZjZkB0aHJlYWQudGFjdjIjIzcwMDdlYzNkLWVkMDEtNGNlZS05ZWEyLTM3YTgwYTdlMGIwOQ=="
        },
        $"https://graph.microsoft.com/beta/teams/{teamsId}/channels/{channelId}/members/{membersId}"
    ),
    {
        body: JSON(
            {
                '@odata.type': "#microsoft.graph.aadUserConversationMember",
                roles: []
            }
        )
    }
)

noch mehr interessante Beiträge

Nach oben scrollen