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 oni znaleźć pokój, dołączyć do niego i wyświetlić jego uczestników.

Aby określić użytkowników w organizacji, którzy mogą znajdować pokoje, do nich dołączać i wyświetlać ich członków, utwórz grupy odbiorców. Docelowi odbiorcy to grupa osób (np. konkretne działy lub cała organizacja), której możesz udostępnić przestrzeń w Google Chat, aby mieć większą kontrolę nad tym, kto ma dostęp do przestrzeni i zawartych w niej informacji. Grupy odbiorców umożliwiają też zarządzanie członkostwem w pokoju i dostosowywanie go, zamiast zapraszać do niego poszczególnych użytkowników. Więcej informacji znajdziesz w artykule Informacje o odbiorcach.

Pokoje z nazwą możesz udostępniać tylko wybranym grupom odbiorców. Nie możesz udostępniać innym typom pokoi, takim jak czaty czy rozmowy grupowe, odbiorcom docelowym.

Wymagania wstępne

Uzyskiwanie identyfikatora docelowych odbiorców

Aby uzyskać identyfikator docelowych 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. Identyfikator docelowych odbiorców 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 Twoich docelowych odbiorców.

W następnej sekcji użyjesz identyfikatora docelowych odbiorców, aby utworzyć pokój możliwy do znalezienia lub zaktualizować istniejący pokój, aby był widoczny dla docelowych odbiorców.

Określanie docelowych 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 istniejącego pokoju, użyj metody update. Tylko nazwane pokoje można udostępniać grupom docelowym, więc typ pokoju (reprezentowany w polu spaceType) musi mieć wartość SPACE.

Aby określić, kto może wyszukiwać pokój, do niego dołączać lub wyświetlać jego użytkowników, umieść obiekt AccessSettings w zasobie Space. W obiekcie użyj pola accessPermissionSettings, aby określić co najmniej 1 z tych uprawnień:

  • Możliwość znalezienia: użyj ikony discoverSpaceSetting, aby określić, kto może znaleźć nazwę i opis pokoju oraz przeglądać go w Google Chat. Możesz określić wiele grup docelowych dla funkcji wykrywania.
  • 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ą mieć też możliwość jego znalezienia. Google Chat obsługuje w przypadku tego uprawnienia tylko jedną grupę docelową.
  • Wyświetlanie osób w pokoju: użyj ikony viewSpaceMembershipSetting, aby określić, kto może wyświetlać listę osób w pokoju. Podczas aktualizowania ustawień widoczności członkostwa w pokoju parametr accessSettings.accessPermissionSettings.viewSpaceMembershipSetting musi być określony razem z parametrem permissionSettings.viewSpaceMembership w parametrze updateMask i treści żądania. Gdy w viewSpaceMembershipSetting skonfigurujesz docelowych odbiorców, wszystkim członkom grupy musi zostać przyznane uprawnienie viewSpaceMembership (wartości managersAllowed, assistantManagersAllowed i membersAllowed muszą być ustawione na true).

Przykład poniżej pokazuje, jak możesz sprawić, aby 2 grupy docelowe mogły wykryć dany pokój, ale członkowie tylko 1 z nich mogli do niego dołączać oraz żeby wszyscy użytkownicy należący do pokoju i określone grupy docelowe mogli wyświetlać listę jego członków:

{
  "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" } }
        ]
      },
      "viewSpaceMembershipSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      }
    }
  },
  "permissionSettings": {
    "viewSpaceMembership": {
      "managersAllowed": true,
      "assistantManagersAllowed": true,
      "membersAllowed": true
    }
  }
}

Zastąp TARGET_AUDIENCE_ID_1 i TARGET_AUDIENCE_ID_2 identyfikatorem docelowych odbiorców uzyskanym w sekcji Pobieranie identyfikatora docelowych odbiorców. Aby użyć domyślnych ustawień udostępniania pokoju w Google Chat w organizacji Google Workspace, zastąp default.

Aby zapewnić wsteczną zgodność, użyj pola audience.

Ze względu na zgodność wsteczną możesz nadal używać pola audience, aby określić jedną grupę docelowych odbiorców, która może dołączyć do przestrzeni, ale zalecamy zamiast tego określanie docelowych odbiorców i szczegółowych uprawnień.

Ustawienie pola audience jest równoznaczne z określeniem docelowych odbiorców w polu joinSpaceSetting:

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

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

Informacje o ustawieniach dostępu w odpowiedziach interfejsu API

Gdy pobierasz lub wyświetlasz listę pokoi, obiekt AccessSettings w odpowiedzi odzwierciedla szczegółowe uprawnienia ustawione dla pokoju.

Te pola w AccessSettings wskazują, czy przestrzeń jest wyszukiwalna i jakie są uprawnienia do dołączania do niej:

  • accessState: pochodzi z uprawnień do odkrywania (discoverSpaceSetting). Jeśli odkrywanie jest przyznane co najmniej 1 odbiorcy docelowemu, to pole ma wartość DISCOVERABLE. W przeciwnym razie jest to PRIVATE.
  • audience: mapowane konkretnie na uprawnienia dołączenia (joinSpaceSetting). Jeśli pojedyncza grupa docelowych odbiorców ma uprawnienia dołączenia, to pole zawiera nazwę zasobu tej grupy docelowych odbiorców.

Pokój możliwy do znalezienia bez odbiorców, którzy mogą do niego dołączyć

Pokój może być widoczny dla docelowych 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 tym przypadku obiekt AccessSettings ma te wartości:

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

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

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

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