Na tej stronie znajdziesz omówienie tego, jak administratorzy Google Workspace mogą używać interfejsu Google Chat API do zarządzania pokojami w Google Chat w całej organizacji.
Aby zarządzać pokojami w Chat, administratorzy Google Workspace mogą używać narzędzia do zarządzania pokojami w konsoli administracyjnej Google lub wywoływać interfejs Google Chat API. Za pomocą interfejsu API Google Chat administratorzy mogą tworzyć aplikacje Google Chat, które zarządzają pokojami na dużą skalę i automatyzują typowe lub powtarzalne zadania.
Co administratorzy mogą robić za pomocą interfejsu Chat API
Administrator może wykonywać zadania związane z zarządzaniem na podstawie przypisanych ról administratora.
Jako administrator Google Workspace możesz wykonywać wiele zadań związanych z zarządzaniem za pomocą interfejsu Chat API, takich jak:
- Wyszukiwanie pokoi na podstawie określonych kryteriów
- Wyświetlanie listy osób w pokoju
- Dodawanie i usuwanie użytkowników z pokoju
- Uzyskiwanie szczegółowych informacji o członku i pokoju
- Aktualizowanie lub usuwanie pokoju
- Aktualizowanie członkostwa użytkownika
Uwierzytelnianie i autoryzacja jako administrator Google Workspace
Podczas korzystania z interfejsu Chat API do wykonywania zadań związanych z zarządzaniem administratorzy mogą uwierzytelniać i autoryzować żądania, wywołując uprawnienia administratora lub konfigurując delegowanie uprawnień w całej domenie na potrzeby konta usługi aplikacji.
W tabeli poniżej opisujemy sposoby uwierzytelniania administratorów podczas korzystania z interfejsu Chat API.
| Uwierzytelnianie użytkowników | Kto wywołuje metodę interfejsu API | Co widzą użytkownicy w Google Chat |
|---|---|---|
| Uprawnienia administratora | Administrator z adresem useAdminAccess=true
|
„Administrator organizacji wykonał [czynność]”. Na przykład „Administrator organizacji zmienił rolę Kiran B na menedżera pokoju”. Nie identyfikuje nazwy ani identyfikatora użytkownika administratora ani nazwy aplikacji Chat. |
| Przekazywanie dostępu w całej domenie | Konto usługi w imieniu użytkownika |
„[Użytkownik] wykonał(a) [działanie] w aplikacji [nazwa aplikacji]”. Na przykład „Sasha T zmienił(-a) nazwę przestrzeni na Dyskusja o projekcie Release”. Użytkownik, za którego podszywa się usługa, jest identyfikowany jako osoba, która wykonała działanie. |
Korzystanie z interfejsu Chat API w organizacji
Przykłady w tej sekcji pokazują, jak administratorzy używają interfejsu Chat API do zarządzania przestrzeniami i członkami organizacji za pomocą uprawnień administratora.
Te metody interfejsu Chat API umożliwiają korzystanie z uprawnień administratora:useAdminAccess=true
spaces.delete()spaces.get()spaces.patch()spaces.search()spaces.members.create()spaces.members.delete()spaces.members.get()spaces.members.list()spaces.members.patch()
Zarządzanie użytkownikami pokoju
Poniżej znajdziesz przykłady, jak jako administrator Google Workspace możesz zarządzać członkostwem użytkowników w pokoju w organizacji za pomocą interfejsu Chat API.
Dodawanie użytkowników do pokoi
Za pomocą spaces.members.create() administratorzy mogą dodawać użytkowników do dowolnego pokoju w organizacji.
W połączeniu z spaces.search() administratorzy mogą dodawać użytkowników do zestawu przestrzeni określonego przez ich zapytanie. Może to być przydatne podczas wdrażania nowych pracowników w organizacji, ponieważ umożliwia administratorom automatyzację rutynowego procesu.
Znajdowanie użytkowników i usuwanie ich z pokoi
Za pomocą spaces.members.get() administratorzy mogą określić, czy użytkownik (wewnętrzny lub zewnętrzny) jest członkiem dowolnego pokoju w organizacji.
W połączeniu z spaces.search() administratorzy mogą znaleźć wszystkie przestrzenie, do których należy użytkownik, a następnie usunąć go z tych przestrzeni za pomocą spaces.members.delete().
Może to być przydatne, gdy pracownicy przenoszą się między zespołami w organizacji lub gdy zwalniają się pracownicy, którzy nie są już związani z organizacją. Umożliwia to administratorom automatyzację rutynowego procesu.
Promowanie użytkowników do roli menedżera pokoju
Za pomocą spaces.members.patch() administratorzy mogą awansować członków pokoju z roli ROLE_MEMBER na ROLE_MANAGER.
Administratorzy mogą też używać ikony spaces.members.patch(), aby przenosić członków z ROLE_MANAGER do ROLE_MEMBER.
W połączeniu z spaces.search() administratorzy mogą wyszukiwać pokoje, które nie mają menedżera, a następnie promować istniejącego członka na rolę ROLE_MANAGER za pomocą spaces.members.patch().
Znajdowanie użytkowników zewnętrznych w pokoju
Korzystając z spaces.members.list(), administratorzy mogą pobrać listę członków pokoju, pobrać profile użytkowników z interfejsu People API lub Directory API organizacji, a następnie odfiltrować wyniki, aby wyświetlić tylko osoby, które są członkami domeny lub organizacji zewnętrznej.
Więcej informacji znajdziesz w artykule Jak czat identyfikuje użytkowników.
Sprawdzanie pokojów i zarządzanie nimi
Poniżej znajdziesz przykłady sytuacji, w których jako administrator Google Workspace możesz kontrolować i zarządzać przestrzeniami w organizacji za pomocą interfejsu Chat API.
Znajdowanie i usuwanie nieaktywnych pokoi
Nieużywane pokoje czatu mogą zajmować cenne miejsce na dane i powodować bałagan w interfejsie. Administratorzy mogą użyć
spaces.search()
do znalezienia nieaktywnych pokoi, a następnie
spaces.delete()
do ich usunięcia. Więcej wskazówek i przykładowy kod znajdziesz w artykule Znajdowanie i usuwanie nieaktywnych pokoi w Google Chat.
Sprawdzanie pokoi w organizacji
Za pomocą spaces.search() administratorzy mogą pobrać listę wszystkich przestrzeni w organizacji ze szczegółowymi informacjami o ustawieniach i metadanych każdej przestrzeni, takimi jak data utworzenia, data ostatniej aktywności, liczba członków, stan ustawienia historii i możliwość zapraszania gości zewnętrznych.
Eksportowanie listy przestrzeni na podstawie kryteriów wyszukiwania
Za pomocą spaces.search() administratorzy mogą pobrać listę przestrzeni spełniających kryteria określone w query i wyeksportować wyniki do pliku CSV w celu analizy.
Znajdowanie osób w pokoju na podstawie kryteriów wyszukiwania
Za pomocą spaces.members.list() administratorzy mogą pobrać listę członków dowolnego pokoju w organizacji i analizować wyniki pod kątem określonych kryteriów.
Znajdowanie menedżerów pokoju
Za pomocą spaces.members.list() administratorzy mogą pobrać listę członków pokoju, która jest filtrowana pod kątem MembershipState=ROLE_MANAGER.
Aby znaleźć wszystkich menedżerów miejsc w organizacji we wszystkich pokojach, możesz użyć opcji spaces.search(), aby wyświetlić ich listę. Następnie dla każdej przestrzeni na liście użyj spaces.members.list, aby pobrać menedżerów.
Powiązane artykuły
- Uwierzytelnianie i autoryzowanie przy użyciu uprawnień administratora
- Wyszukiwanie pokojów w Google Chat i zarządzanie nimi za pomocą interfejsu Google Chat API jako administrator Google Workspace
spaces.search()metoda