Na tej stronie dowiesz się, jak za pomocą interfejsu Google Chat API udostępnić pokój w Google Chat określonym użytkownikom w organizacji Google Workspace, aby mogli go znaleźć i do niego dołączyć.
Aby określić użytkowników w organizacji, którzy mogą znajdować pokoje i do nich dołączać, utwórz grupy odbiorców. Grupa odbiorców to grupa osób – na przykład konkretne działy lub cała organizacja – której możesz udostępnić pokój w Chat, aby zwiększyć jego widoczność i możliwość udostępniania. Grupy odbiorców umożliwiają też zarządzanie członkostwem w pokoju i dostosowywanie go, dzięki czemu nie musisz zapraszać do niego poszczególnych użytkowników. Więcej informacji znajdziesz w artykule Informacje o odbiorcach docelowych.
Pokoje z nazwą możesz udostępniać tylko wybranym grupom odbiorców. Nie możesz udostępniać grup odbiorców innym typom pokoi, takim jak czaty czy rozmowy grupowe.
Wymagania wstępne
- Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat. Twoje konto musi mieć rolę superadministratora w organizacji Google Workspace.
- Grupa odbiorców, która jest dostępna w Google Chat. Aby utworzyć grupę odbiorców, przeczytaj artykuł Tworzenie grupy odbiorców. Aby udostępnić istniejącą grupę odbiorców w pokojach czatu, zapoznaj się z artykułem Konfigurowanie dostępu do pokoi na potrzeby Google Chat.
- Musisz wywołać interfejs Google Chat API z uwierzytelnianiem użytkownika.
Uzyskiwanie identyfikatora grupy odbiorców
Aby uzyskać identyfikator grupy docelowej:
W konsoli administracyjnej Google otwórz Menu > Katalog > Grupy odbiorców.
W tabeli Grupy odbiorców kliknij pole Nazwa grupy odbiorców.
Identyfikator odbiorców docelowych znajdziesz w adresie URL strony. Format adresu URL to
https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID
, gdzieTARGET_AUDIENCE_ID
to identyfikator alfanumeryczny Twojej grupy docelowej.
W następnej sekcji użyjesz identyfikatora grupy docelowej, aby utworzyć przestrzeń, którą można znaleźć, lub zaktualizować istniejącą przestrzeń, aby była widoczna dla grupy docelowej.
Określanie docelowych odbiorców w żądaniu do interfejsu Chat API
Aby utworzyć przestrzeń dla określonej grupy odbiorców, użyj metody create()
lub setup()
w zasobie Space
. Aby zmienić poziom dostępu z możliwego do znalezienia na ograniczony, użyj metody update()
w zasobie Space
. Tylko nazwane pokoje można udostępniać grupom docelowym, więc typ pokoju (reprezentowany w polu spaceType
) musi mieć wartość SPACE
.
Aby pokój był widoczny dla grupy docelowej, w żądaniu wysyłanym do Chat API umieść obiekt AccessSettings
w zasobie Space
. W obiekcie określ pole audience
:
"accessSettings": { "audience": "audiences/TARGET_AUDIENCE_ID" }
Zastąp TARGET_AUDIENCE_ID
identyfikatorem docelowej grupy odbiorców uzyskanym w poprzedniej sekcji. Aby użyć domyślnych ustawień udostępniania pokoju w Google Chat w organizacji Google Workspace, zastąp default
.
Szczegółowe informacje o tworzeniu i aktualizowaniu pokoi za pomocą interfejsu Chat API znajdziesz w tych przewodnikach:
Powiązane artykuły
- Tworzenie grupy odbiorców
- Konfigurowanie udostępniania w Google Chat
- Tworzenie pokoi z różnymi poziomami dostępu