API Telegrama pozwala pobrać informacje o członkach SuperGrupy. Użyj metody GetSuperGroupMembers, aby uzyskać informacje o członkach lub zbanowanych użytkownikach supergrupy albo kanału. Można jej użyć tylko, gdy SupergroupFullInfo.can_get_members ma wartość true; dodatkowo dla niektórych filtrów mogą być wymagane uprawnienia administratora.
Domyślnie metoda zwraca wszystkich członków grupy, ale za pomocą parametru Filter możesz odfiltrować zwracane wyniki. Od wersji sgcWebSockets 4.5.0 metoda została ulepszona i umożliwia filtrowanie członków przy użyciu zestawu parametrów.
Filtry
Dostępne są następujące parametry:
- tsgmFilterNone: Wartość domyślna, oznacza, że członkowie nie są filtrowani.
- tsgmFilterAdministrators: Zwraca twórcę i administratorów.
- tsgmFilterBanned: Zwraca użytkowników zbanowanych w supergrupie lub kanale; może być użyte tylko przez administratorów. Możesz użyć argumentu aSuperGroupMembersQuery do wyszukiwania za pomocą zapytania.
- tsgmFilterBots: Zwraca członków-botów supergrupy lub kanału.
- tsgmFilterContacts: Zwraca kontakty użytkownika, którzy są członkami supergrupy lub kanału. Możesz użyć argumentu aSuperGroupMembersQuery do wyszukiwania za pomocą zapytania.
- tsgmFilterMention: Zwraca użytkowników, których można wzmiankować w supergrupie.
- tsgmFilterRecent: Zwraca użytkowników aktywnych ostatnio, w odwrotnej kolejności chronologicznej.
- tsgmFilterRestricted: Zwraca członków supergrupy z ograniczeniami; może być użyte tylko przez administratorów. Możesz użyć argumentu aSuperGroupMembersQuery do wyszukiwania za pomocą zapytania.
- tsgmFilterSearch: Służy do wyszukiwania członków supergrupy lub kanału za pomocą zapytania (ciąg znaków). Możesz użyć argumentu aSuperGroupMembersQuery do wyszukiwania za pomocą zapytania.
Wynik możesz odczytać w callbacku OnEvent, filtrując po event = "chatMembers".
Telegram.GetSupergroupMembers(1452979380);
procedure OnTelegramEvent(Sender: TObject; const Event, Text: string);
begin
if Event = 'chatMembers' then
ReadJSON(Text);
end;