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

Z tej strony dowiesz się, jak udostępnić pokój Google Chat określonym użytkownikom w organizacji Google Workspace za pomocą interfejsu Google Chat API, aby mogli oni znaleźć pokój i do niego dołączyć.

Aby określić użytkowników w organizacji, którzy mogą znaleźć pokój i do niego dołączyć, utwórz grupy odbiorców. Grupa odbiorców to grupa osób (np. określone działy lub cała organizacja), której możesz udostępnić pokój Google Chat, aby zwiększyć jego widoczność i możliwość udostępniania. Grupy odbiorców umożliwiają też zarządzanie członkostwem w pokoju i jego dostosowywanie bez konieczności zapraszania poszczególnych użytkowników do pokoju. Więcej informacji znajdziesz w artykule Informacje o grupach odbiorców.

Tylko nazwane pokoje mogą być widoczne dla grup odbiorców. Nie możesz udostępniać grup odbiorców innych typów pokoi, takich jak czaty bezpośrednie czy rozmowy grupowe.

Wymagania wstępne

Uzyskiwanie identyfikatora grupy odbiorców

Aby uzyskać identyfikator grupy odbiorców:

  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 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 użyjesz identyfikatora grupy odbiorców, aby utworzyć pokój, do którego użytkownik może dołączyć, lub zaktualizować istniejący pokój, aby był widoczny dla grupy odbiorców.

Określanie grup odbiorców i szczegółowych uprawnień

Aby utworzyć pokój z określonymi uprawnieniami dostępu, użyj metody create lub setup w zasobie Space. Aby zaktualizować uprawnienia do istniejącego pokoju, użyj metody update. Ponieważ tylko nazwane pokoje można udostępniać grupom odbiorców, typ pokoju (reprezentowany w polu spaceType) musi mieć wartość SPACE.

Aby określić, kto może znaleźć pokój lub do niego dołączyć, dodaj obiekt AccessSettings do zasobu Space. W obiekcie użyj pola accessPermissionSettings, aby określić co najmniej 1 z tych uprawnień:

  • Możliwość znalezienia: użyj discoverSpaceSetting, aby określić, kto może znaleźć nazwę i opis pokoju oraz wyszukać go w Google Chat. Możesz określić wiele grup odbiorców, które mogą znaleźć pokój.
  • Możliwość dołączenia: użyj joinSpaceSetting, aby określić, kto może dołączyć do pokoju bez wyraźnego zaproszenia i wyświetlić podgląd wiadomości w pokoju. Użytkownicy, którzy mogą dołączyć do pokoju, muszą też mieć możliwość jego znalezienia. Google Chat obsługuje tylko 1 grupę odbiorców w przypadku tego uprawnienia.

Poniższy przykład pokazuje, jak sprawić, aby 2 grupy docelowe mogły wykryć dany pokój, ale członkowie tylko 1 z nich mogli do niego dołączać:

  "accessSettings": {
    "accessPermissionSettings": {
      "discoverSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      },
      "joinSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } }
        ]
      }
    }
  }

Zastąp TARGET_AUDIENCE_ID_1 i TARGET_AUDIENCE_ID_2 identyfikatorem grupy odbiorców, który został uzyskany w sekcji Uzyskiwanie identyfikatora grupy odbiorców. Aby użyć domyślnych ustawień udostępniania pokoju Google Chat w organizacji Google Workspace, zastąp wartość default.

Na potrzeby zgodności wstecznej użyj pola audience

Na potrzeby zgodności wstecznej możesz nadal używać pola audience, aby określić 1 grupę odbiorców, która może dołączyć do pokoju, ale zalecamy używanie opcji Określanie grup odbiorców i szczegółowych uprawnień.

Ustawienie pola audience jest równoznaczne z określeniem grupy odbiorców w polach joinSpaceSetting i discoverSpaceSetting:

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

Zastąp TARGET_AUDIENCE_ID identyfikatorem grupy odbiorców, który został uzyskany w sekcji Uzyskiwanie identyfikatora grupy odbiorców. Aby użyć domyślnych ustawień udostępniania pokoju Google Chat w organizacji Google Workspace, zastąp wartość default.

Informacje o ustawieniach dostępu w odpowiedziach interfejsu API

Gdy pobierasz pokoje, obiekt w odpowiedzi odzwierciedla szczegółowe uprawnienia ustawione dla pokoju.AccessSettings

Te pola w AccessSettings wskazują, czy pokój można wyszukiwać i kto może do niego dołączyć:

  • accessState: pochodzi z uprawnień do wyszukiwania (discoverSpaceSetting). Jeśli wyszukiwanie jest przyznane co najmniej 1 grupie odbiorców, to pole ma wartość DISCOVERABLE. W przeciwnym razie ma wartość PRIVATE.
  • audience: mapowane konkretnie na uprawnienia do dołączania (joinSpaceSetting). Jeśli uprawnienie do dołączania jest przyznane 1 grupie odbiorców, to pole zawiera nazwę zasobu tej grupy odbiorców.

Pokój, do którego użytkownik może dołączyć, ale nie ma grupy odbiorców

Pokój może być widoczny dla grupy odbiorców, ale nie można do niego dołączyć bezpośrednio (np. jeśli użytkownicy muszą zostać wyraźnie zaproszeni do dołączenia).

W takim przypadku obiekt AccessSettings ma te wartości:

  • accessState: DISCOVERABLE
  • audience: pominięte lub null

Jeśli widzisz, że accessState ma wartość DISCOVERABLE, ale audience nie jest obecne, oznacza to, że pokój może być znaleziony przez grupy odbiorców określone w discoverSpaceSetting, ale można do niego dołączyć tylko po otrzymaniu zaproszenia. Aby sprawdzić, które grupy odbiorców mogą znaleźć pokój, sprawdź accessPermissionSettings.discoverSpaceSetting pole.

Więcej informacji o grupach odbiorców znajdziesz w tych przewodnikach:

Więcej informacji o tworzeniu i aktualizowaniu pokoi za pomocą interfejsu Chat API znajdziesz w tych przewodnikach: