Zarządzanie pokojami Google Chat jako administrator Google Workspace

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 Google Chat, administratorzy Google Workspace mogą używać narzędzia do zarządzania pokojem w konsoli administracyjnej Google lub wywoływać interfejs Google Chat API. Za pomocą interfejsu Chat API 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 mu ról administratora.

Jako administrator Google Workspace możesz wykonywać wiele zadań związanych z zarządzaniem za pomocą interfejsu Chat API, takich jak:

Jak uwierzytelnić się i autoryzować 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 konto usługi aplikacji.

W tabeli poniżej opisujemy, jak administratorzy mogą się uwierzytelniać 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 parametrem useAdminAccess=true

„Administrator organizacji wykonał [działanie]”.

Na przykład: „Administrator organizacji zmienił rolę użytkownika Kiran B na menedżera pokoju”.

Nie identyfikuje nazwy użytkownika administratora ani jego identyfikatora, ani nazwy aplikacji Google Chat.
Delegowanie uprawnień 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 Dyskusja o projekcie Release”.

Użytkownik, którego rolę odgrywa 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 korzystają z interfejsu Chat API podczas zarządzania pokojami i osobami w organizacji z uprawnieniami administratora.

Te metody interfejsu Chat API umożliwiają korzystanie z uprawnień administratora z parametrem useAdminAccess=true:

Zarządzanie członkostwem użytkowników w pokojach

Poniżej znajdziesz przykłady, jak jako administrator Google Workspace możesz zarządzać członkostwem użytkowników w pokojach za pomocą interfejsu Chat API.

Dodawanie użytkowników do pokoi

Za pomocą metody spaces.members.create, administratorzy mogą dodawać użytkowników do dowolnego pokoju w organizacji.

W połączeniu z metodą spaces.search, administratorzy mogą dodawać użytkowników do zestawu pokoi określonego przez zapytanie. Może to być przydatne podczas wdrażania nowych pracowników w organizacji, ponieważ umożliwia administratorom zautomatyzowanie rutynowego procesu.

Znajdowanie użytkowników i usuwanie ich z pokoi

Za pomocą metody spaces.members.get, administratorzy mogą sprawdzić, czy użytkownik (wewnętrzny lub zewnętrzny) jest członkiem dowolnego pokoju w organizacji.

W połączeniu z metodą spaces.search, administratorzy mogą znaleźć wszystkie pokoje, do których należy użytkownik, a następnie usunąć go z tych pokoi za pomocą metody spaces.members.delete. Może to być przydatne, gdy pracownicy przenoszą się między zespołami w organizacji lub gdy pracownicy odchodzą z organizacji, ponieważ umożliwia administratorom zautomatyzowanie rutynowego procesu.

Promowanie użytkowników na menedżerów pokoju

Za pomocą metody spaces.members.patch, administratorzy mogą zmieniać rolę użytkownika, aktualizując jego MembershipRole za pomocą jednej z tych opcji:

  • ROLE_MEMBER: osoba w pokoju. W interfejsie Google Chat ta rola nosi nazwę Osoba.
  • ROLE_ASSISTANT_MANAGER: menedżer pokoju. W interfejsie Google Chat ta rola nosi nazwę Menedżer.
  • ROLE_MANAGER: właściciel pokoju. W interfejsie Google Chat ta rola nosi nazwę Właściciel.

W połączeniu z metodą spaces.search, administratorzy mogą znaleźć pokoje, które nie mają menedżera ani właściciela, a następnie promować istniejącego użytkownika na menedżera lub właściciela za pomocą metody spaces.members.patch.

Znajdowanie osób z zewnątrz w pokoju

Za pomocą metody spaces.members.list, administratorzy mogą pobrać listę osób w pokoju, pobrać profile użytkowników z interfejsu People API lub Directory API organizacji, a następnie odfiltrować wyniki, aby wyświetlić osoby należące do domeny lub organizacji zewnętrznej. Więcej informacji znajdziesz w artykule Jak Google Chat identyfikuje użytkowników.

Kontrola i zarządzanie pokojami

Poniżej znajdziesz przykłady, jak jako administrator Google Workspace możesz kontrolować pokoje w organizacji i nimi zarządzać za pomocą interfejsu Chat API.

Znajdowanie i usuwanie nieaktywnych pokoi

Nieużywane pokoje w Google Chat mogą zajmować cenne miejsce na dysku i powodować bałagan w interfejsie użytkownika. Administratorzy mogą używać spaces.search , aby znaleźć nieaktywne pokoje, a następnie spaces.delete , aby je usunąć. Więcej wskazówek i przykładowy kod znajdziesz w artykule Znajdowanie i usuwanie nieaktywnych pokoi w Google Chat.

Kontrolowanie pokoi w organizacji

Za pomocą metody spaces.search, administratorzy mogą pobrać listę wszystkich pokoi w organizacji ze szczegółowymi informacjami o ustawieniach i metadanych każdego pokoju, takimi jak data utworzenia, data ostatniej aktywności, liczba osób, stan ustawienia historii i możliwość zapraszania gości z zewnątrz.

Eksportowanie listy pokoi na podstawie kryteriów wyszukiwania

Za pomocą metody spaces.search, administratorzy mogą pobrać listę pokoi, które spełniają kryteria określone w parametrze query i wyeksportować wyniki do pliku CSV w celu analizy.

Znajdowanie osób w pokoju na podstawie kryteriów wyszukiwania

Za pomocą metody spaces.members.list, administratorzy mogą pobrać listę osób w dowolnym pokoju w organizacji i przeanalizować wyniki pod kątem określonych kryteriów.

Znajdowanie menedżerów pokoju

Za pomocą metody spaces.members.list, administratorzy mogą pobrać listę osób w pokoju, która jest filtrowana według parametru MembershipState=ROLE_MANAGER.

Aby znaleźć wszystkich menedżerów pokoju w organizacji we wszystkich pokojach, możesz użyć spaces.search, aby wyświetlić ich listę. Następnie w przypadku każdego pokoju na liście użyj metody spaces.members.list, aby pobrać menedżerów.