= user_groups()
:description: Gibt die Gruppen, denen ein Benutzer angehört, als Liste von ECMGroup-Objekten zurück (mng.GetUserGroups). Enthält internen Namen und Anzeigenamen je Gruppe.
:keywords: user_groups, mng.GetUserGroups, ECMGroup, Benutzergruppen
:page-tags: api, security

Gibt alle Gruppen zurück, denen der angegebene Benutzer angehört.

== Signatur

[tabs]
====
Sync::
+
[source,python]
----
ecm.security.user_groups(user_guid: str) -> list[ECMGroup]
----

Async::
+
[source,python]
----
await ecm.security.user_groups(user_guid: str) -> list[ECMGroup]
----
====

== Parameter

[cols="1,1,3"]
|===
|Parameter |Standard |Beschreibung

|`user_guid`
|—
|GUID des Benutzers, dessen Gruppenmitgliedschaften abgerufen werden sollen.
|===

== Rückgabewert

Liste von `ECMGroup`-Instanzen. Leere Liste, wenn der Benutzer keiner Gruppe angehört.

Felder von `ECMGroup` — siehe xref:api/security/groups.adoc[groups()].

== Beispiele

=== Gruppen eines Benutzers abrufen

[tabs]
====
Sync::
+
[source,python]
----
user = ecm.security.user("john")
if user:
    groups = ecm.security.user_groups(user.guid)
    for group in groups:
        print(group.name)
----

Async::
+
[source,python]
----
user = await ecm.security.user("john")
if user:
    groups = await ecm.security.user_groups(user.guid)
    for group in groups:
        print(group.name)
----
====

=== Prüfen ob Benutzer Mitglied einer bestimmten Gruppe ist

[tabs]
====
Sync::
+
[source,python]
----
user = ecm.security.user("john")
if user:
    groups = ecm.security.user_groups(user.guid)
    is_admin = any(g.name == "Administrators" for g in groups)
    print(f"john ist Admin: {is_admin}")
----

Async::
+
[source,python]
----
user = await ecm.security.user("john")
if user:
    groups = await ecm.security.user_groups(user.guid)
    is_admin = any(g.name == "Administrators" for g in groups)
    print(f"john ist Admin: {is_admin}")
----
====

== Siehe auch

* xref:api/security/users.adoc[users()] — Alle Benutzer mit Gruppenliste (`extended_info=True`)
* xref:api/security/groups.adoc[groups()] — Alle Gruppen des Servers
* xref:api/security/group_members.adoc[group_members()] — Mitglieder einer Gruppe abrufen
