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 oni go znaleźć i do niego dołączyć.

Aby określić użytkowników w organizacji, którzy mogą odkrywać pokój i do niego dołączać, utwórz grupy odbiorców. Grupa odbiorców to grupa osób – na przykład określone działy lub cała organizacja – którym możesz udostępniać pokój czatu, aby zwiększyć świadomość pokoju i możliwość udostępniania go innym. Grupy odbiorców pozwalają też zarządzać członkostwem w pokoju i dostosowywać go bez konieczności zapraszania poszczególnych użytkowników do pokoju. Więcej informacji znajdziesz w artykule Informacje o grupach odbiorców.

Pokoje nazwane mogą być wykrywalne tylko dla grup odbiorców. Grupom odbiorców nie można udostępniać innych typów pokoi, takich jak czaty lub rozmowy grupowe.

Wymagania wstępne

Uzyskiwanie identyfikatora grupy odbiorców

Aby uzyskać identyfikator grupy odbiorców:

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

    Otwórz stronę Grupy odbiorców

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

  3. Znajdź identyfikator grupy odbiorców 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 za pomocą identyfikatora grupy odbiorców utworzysz pokój możliwy do znalezienia lub zaktualizujesz istniejący pokój, aby był on wykrywalny dla odbiorców docelowych.

Określanie grupy 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 ustawić istniejący pokój jako wykrywalny, użyj metody update() w zasobie Space. Grupom odbiorców można udostępniać tylko pokoje z nazwami, więc typ pokoju (reprezentowany w polu spaceType) musi mieć wartość SPACE.

Aby pokój był widoczny dla grupy odbiorców, dodaj obiekt AccessSettings do zasobu Space w ramach żądania do interfejsu Chat API. W obiekcie podaj pole audience:

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

Zastąp TARGET_AUDIENCE_ID identyfikatorem grupy odbiorców uzyskanym w poprzedniej sekcji. Aby używać domyślnych ustawień udostępniania pokoi czatu w organizacji Google Workspace, zastąp ją tekstem default.

Szczegółowe informacje o tworzeniu i aktualizowaniu pokoi za pomocą interfejsu Chat API znajdziesz w tych przewodnikach: