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ć pokój możliwy do znalezienia lub zaktualizować istniejącą przestrzeń, aby była widoczna dla grupy docelowej.

Określanie grupy docelowej w żądaniu do interfejsu Chat API

Aby utworzyć pokój dla określonej grupy odbiorców, użyj metody create() lub setup() w zasobie Space. Aby ustawić istniejący pokój jako możliwy do znalezienia, 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 ramach żądania do interfejsu Chat API uwzględnij 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: