Na tej stronie znajdziesz omówienie tego, jak administratorzy Google Workspace mogą używać interfejsu Google Chat API do zarządzania pokojami Google Chat w organizacji.
Aby zarządzać pokojami Google Chat, administratorzy Google Workspace mogą użyć narzędzia do zarządzania pokojem w konsoli administracyjnej Google lub wywołać 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ą ich typowe lub powtarzalne zadania.
Co administratorzy mogą robić za pomocą interfejsu API Google Chat
Administrator może wykonywać zadania administracyjne na podstawie przypisanych ról administratora.
Jako administrator Google Workspace możesz wykonywać za pomocą interfejsu Chat API wiele zadań związanych z zarządzaniem, na przykład:
- Wyszukiwanie pokoju na podstawie określonych kryteriów
- Lista użytkowników pokoju
- dodawać użytkowników do pokoju oraz usuwać ich z pokoju;
- Uzyskiwanie szczegółowych informacji o członku i pokoju
- Zaktualizuj lub usuń pokój
- Aktualizowanie członkostwa użytkownika
Jak uwierzytelnić się jako administrator Google Workspace i uzyskać autoryzację
Gdy administratorzy korzystają z interfejsu API czatu do zadań administracyjnych, mogą uwierzytelniać i autoryzować żądania, wywołując uprawnienia administratora lub konfigurując delegowanie uprawnień na poziomie domeny dla konta usługi aplikacji.
W tabeli poniżej opisano sposoby uwierzytelniania administratorów podczas korzystania z interfejsu API czatu.
| Uwierzytelnianie użytkowników | Kto wywołuje metodę interfejsu API | Co widzą użytkownicy w Google Chat |
|---|---|---|
| Uprawnienia administratora | Administrator w useAdminAccess=true
|
„Administrator organizacji wykonał [działanie]”. Na przykład: „Administrator organizacji zmienił rolę Kiran B. na menedżera pokoju”. Nie zawiera nazwy ani identyfikatora użytkownika administratora ani nazwy aplikacji Google Chat. |
| Przekazywanie dostępu w całej domenie | Konto usługi w imieniu użytkownika |
„[Użytkownik] wykonał [działanie] za pomocą [nazwa aplikacji]”. Na przykład „Sasha T zmienił nazwę pokoju na Rozmowa na temat projektu wydania”. Użytkownik, którego usługa podszywa się pod niego, jest identyfikowany jako wykonawca danego działania. |
Korzystanie z interfejsu API Google Chat w organizacji
Przykłady w tej sekcji pokazują, jak administratorzy używają interfejsu Chat API do zarządzania pokojami i użytkownikami organizacji z uprawnieniami administratora.
Te metody interfejsu Chat API umożliwiają przyznawanie uprawnień administratora za pomocą funkcji 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
W podanych niżej scenariuszach opisujemy, jak jako administrator Google Workspace możesz zarządzać członkostwem w pokoju użytkowników w Twojej organizacji za pomocą interfejsu Google Chat API.
Dodawanie użytkowników do pokoi
Za pomocą spaces.members.create() administratorzy mogą dodawać użytkowników do dowolnego pokoju w organizacji.
Korzystając z funkcji spaces.search(), administratorzy mogą dodawać użytkowników do zestawu pomieszczeń określonych na podstawie ich zapytania wyszukiwania. Może to być przydatne podczas wprowadzania nowych pracowników do organizacji, ponieważ pozwala administratorom zautomatyzować rutynowe procesy.
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 organizacji) jest członkiem dowolnego pokoju w organizacji.
Za pomocą funkcji spaces.search() administratorzy mogą znaleźć wszystkie pokoje, w których znajduje się użytkownik, a następnie usunąć go z tych pokoi za pomocą funkcji spaces.members.delete().
Może to być przydatne, gdy pracownicy przechodzą do innych zespołów w organizacji lub opuszczają organizację. Pozwala to administratorom zautomatyzować rutynowe procesy.
Przypisywanie roli menedżera pokoju użytkownikom
Za pomocą aplikacji spaces.members.patch() administratorzy mogą awansować użytkowników pokoju z poziomu ROLE_MEMBER do poziomu ROLE_MANAGER.
Administratorzy mogą też używać spaces.members.patch(), aby przenosić użytkowników z ROLE_MANAGER do ROLE_MEMBER.
Za pomocą polecenia spaces.search() administratorzy mogą znajdować pokoje bez menedżera, a następnie awansować obecnego członka na ROLE_MANAGER za pomocą polecenia spaces.members.patch().
Znajdowanie zewnętrznych użytkowników pokoju
Za pomocą interfejsu spaces.members.list() administratorzy mogą pobierać listę członków w pokoju, pobierać profile użytkowników z interfejsu People API lub Directory API organizacji, a następnie filtrować wyniki pod kątem użytkowników z zewnętrznej domeny lub organizacji.
Więcej informacji znajdziesz w artykule Jak czat identyfikuje użytkowników.
Sprawdzanie i zarządzanie pokojami
W podanych niżej scenariuszach opisujemy sposoby, dzięki którym jako administrator Google Workspace możesz sprawdzać i zarządzać pokojami w organizacji za pomocą interfejsu API Google Chat.
Znajdowanie i usuwanie nieaktywnych pokoju
Nieużywane pokoje czatu mogą zajmować cenne miejsce na dane i zaśmiecać interfejs. Administratorzy mogą użyć opcji spaces.search(), aby znaleźć nieaktywne pokoje, a następnie użyć opcji spaces.delete(), aby je usunąć. Więcej wskazówek i przykładowy kod znajdziesz w artykule Znajdowanie i usuwanie nieaktywnych pokoi Google Chat.
kontrolować pokoje w organizacji;
Za pomocą spaces.search() administratorzy mogą pobrać listę wszystkich pomieszczeń w organizacji wraz ze szczegółowymi informacjami o ustawieniach i metadanych każdego pokoju, takimi jak data utworzenia, data ostatniej aktywności, liczba członków, stan ustawienia historii oraz możliwość zapraszania zewnętrznych gości.
Eksportowanie listy pokoi na podstawie kryteriów wyszukiwania
Za pomocą funkcji spaces.search() administratorzy mogą pobrać listę pomieszczeń, które spełniają kryteria określone w query, i wyeksportować wyniki do pliku CSV na potrzeby analizy.
Znajdowanie użytkowników pokoju na podstawie kryteriów wyszukiwania
Za pomocą spaces.members.list() administratorzy mogą pobrać listę członków dowolnej przestrzeni w organizacji i przeanalizować wyniki pod kątem określonych kryteriów.
Znajdowanie menedżerów pokoju
Za pomocą interfejsu spaces.members.list() administratorzy mogą pobrać listę użytkowników pokoju, który jest filtrowany do MembershipState=ROLE_MANAGER.
Aby znaleźć wszystkich menedżerów miejsca w organizacji we wszystkich pokojach, możesz użyć spaces.search(), aby wyświetlić ich wszystkich. Następnie dla każdego pokoju na liście użyj polecenia spaces.members.list, aby pobrać menedżerów.
Powiązane artykuły
- Uwierzytelnianie i autoryzowanie przy użyciu uprawnień administratora
- Wyszukiwanie pokoi Google Chat i zarządzanie nimi za pomocą interfejsu Google Chat API przez administratora Google Workspace
spaces.search()metoda