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 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 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 ról administratora.

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

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ł [działanie]”.

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

Nie identyfikuje nazwy użytkownika administratora ani jego identyfikatora, 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

Zarządzanie członkostwem użytkowników w 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ą zmienić rolę członka, aktualizując jego MembershipRole w jednym z tych wariantów:

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

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

Znajdowanie użytkowników zewnętrznych w pokoju

Za pomocą 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 pokoi 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żywać spaces.search do wyszukiwania nieaktywnych pokoi, a następnie spaces.delete do ich usuwania. 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żdego pokoju na liście użyj spaces.members.list, aby pobrać menedżerów.