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

Na tej stronie wyjaśniamy, jak za pomocą interfejsu Google Chat API udostępnić pokój Google Chat określonym użytkownikom w organizacji Google Workspace, aby mogli go znaleźć i do niego dołączyć.

Aby określić, którzy użytkownicy w organizacji mogą znaleźć pokój i do niego dołączyć, utwórz grupy odbiorców docelowych. Grupa odbiorców to grupa osób (np. konkretne działy lub cała organizacja), którym możesz udostępnić pokój Google Chat, aby zwiększyć jego rozpoznawalność i możliwość udostępniania. Za pomocą list odbiorców możesz też zarządzać członkostwem w pokoju i dostosowywać je, zamiast zapraszać pojedynczych użytkowników do pokoju. Więcej informacji znajdziesz w artykule Informacje o docelowych grupach odbiorców.

Możesz udostępnić nazwane pokoje tylko wybranym odbiorcom. Nie możesz udostępniać innym grupom odbiorców innych typów pokoi, takich jak czaty lub rozmowy grupowe.

Wymagania wstępne

Uzyskiwanie identyfikatora grupy odbiorców docelowych

Aby uzyskać identyfikator grupy odbiorców docelowych, wykonaj te czynności:

  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. Znajdź identyfikator listy odbiorców docelowych w adresie URL strony. Format adresu URL to https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID, gdzie TARGET_AUDIENCE_ID to alfanumeryczny identyfikator grupy odbiorców.

W następnej sekcji użyjesz identyfikatora docelowej listy odbiorców, aby utworzyć przestrzeń możliwą do odkrycia lub zaktualizować istniejącą, aby była ona możliwa do odkrycia przez docelową listę odbiorców.

Określanie docelowych odbiorców 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 udostępnić istniejący pokój, użyj metody update() zasobu Space. Tylko nazwane pokoje można udostępniać grupom odbiorców, dlatego typ pokoju (reprezentowany w polu spaceType) musi być SPACE.

Aby udostępnić pokój docelowej grupie odbiorców, dodaj obiekt AccessSettings do zasobu Space w żądaniu interfejsu API Google Chat. W obiekcie określ pole audience:

  "accessSettings": {
    "audience": "audiences/TARGET_AUDIENCE_ID"
  }

Zastąp TARGET_AUDIENCE_ID identyfikatorem grupy odbiorców docelowych, który został podany w poprzedniej sekcji. Aby użyć domyślnych ustawień udostępniania pokoju 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: