Ustawianie pokoju Google Chat jako wykrywalnego dla określonych użytkowników w organizacji Google Workspace

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

Uzyskiwanie identyfikatora grupy odbiorców

Aby uzyskać identyfikator grupy docelowej:

  1. W konsoli administracyjnej Google otwórz Menu  > Katalog > Grupy odbiorców.

    Otwórz Grupy odbiorców

  2. W tabeli Grupy odbiorców kliknij pole Nazwa grupy odbiorców.

  3. Identyfikator odbiorców docelowych znajdziesz w adresie URL strony. Format adresu URL to https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID, gdzie TARGET_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: