Zasób: Space
Pokój w Google Chat. Pokoje to rozmowy między co najmniej 2 użytkownikami lub wiadomości 1:1 między użytkownikiem a aplikacją Google Chat.
Zapis JSON |
---|
{ "name": string, "type": enum ( |
Pola | |
---|---|
name |
Nazwa zasobu pokoju. Format: |
type |
Tylko dane wyjściowe. Wycofane: użyj atrybutu |
spaceType |
Typ pokoju. Wymagane podczas tworzenia pokoju lub aktualizowania jego typu. Dane wyjściowe tylko do innych zastosowań. |
singleUserBotDm |
Opcjonalnie: Określa, czy pokój jest czatem między aplikacją Google Chat a jednym człowiekiem. |
threaded |
Tylko dane wyjściowe. Wycofane: użyj atrybutu |
displayName |
Wyświetlana nazwa pokoju. Wymagane podczas tworzenia pokoju. Jeśli podczas tworzenia pokoju lub aktualizowania pokoju W przypadku czatów to pole może być puste. Może mieć do 128 znaków. |
externalUserAllowed |
Stały. Określa, czy ten pokój pozwala na dołączenie dowolnego użytkownika Google Chat. Wprowadź podczas tworzenia pokoju w organizacji Google Workspace. Pomiń to pole podczas tworzenia pokoi w tych warunkach:
W przypadku dotychczasowych pokoi to pole zawiera tylko dane wyjściowe. |
spaceThreadingState |
Tylko dane wyjściowe. Stan wątku w pokoju czatu. |
spaceDetails |
Informacje o pokoju, w tym opis i reguły. |
spaceHistoryState |
Stan historii wiadomości dla wiadomości i wątków w tym pokoju. |
importMode |
Opcjonalnie: Określa, czy ten pokój został utworzony w usłudze |
createTime |
Opcjonalnie: Stały. W przypadku pokoi utworzonych w Google Chat jest to czas utworzenia pokoju. To pole dotyczy tylko danych wyjściowych, chyba że jest używane w pokojach w trybie importowania. W przypadku pokoi w trybie importowania ustaw w tym polu historyczną sygnaturę czasową, w której pokój został utworzony w źródle, aby zachować pierwotny czas utworzenia pokoju. Wartość podawana w danych wyjściowych tylko wtedy, gdy |
lastActiveTime |
Tylko dane wyjściowe. Sygnatura czasowa ostatniej wiadomości w pokoju. |
adminInstalled |
Tylko dane wyjściowe. w przypadku pokoi czatu z aplikacją Google Chat – informacja o tym, czy pokój został utworzony przez administratora Google Workspace; Administratorzy mogą zainstalować i skonfigurować czat w aplikacji Google Chat w imieniu użytkowników w swojej organizacji. Aby instalacja była obsługiwana przez administratora, aplikacja Google Chat musi obsługiwać czat. |
membershipCount |
Tylko dane wyjściowe. Liczba osób, które dołączyły, pogrupowane według typu wspierającego. Wartość wypełniana, gdy |
accessSettings |
Opcjonalnie: Określa ustawienie dostępu do pokoju. Wartość jest podawana tylko wtedy, gdy |
spaceUri |
Tylko dane wyjściowe. Identyfikator URI umożliwiający użytkownikowi dostęp do pokoju. |
Pole sumy space_permission_settings . Reprezentuje ustawienia uprawnień pokoju. Wartość jest podawana tylko wtedy, gdy space_type ma wartość SPACE . space_permission_settings może mieć tylko jedną z tych wartości: |
|
predefinedPermissionSettings |
Opcjonalnie: Tylko dane wejściowe. Ustawienia uprawnień pokoju. Dane wejściowe do utworzenia pokoju. Jeśli to pole nie jest skonfigurowane, tworzony jest pokój współpracy. Po utworzeniu pokoju ustawienia zostaną wypełnione w polu |
permissionSettings |
Opcjonalnie: Dokładne ustawienia uprawnień, które można skonfigurować w celu aktualizowania pokoju. Pole na aktualizowanie pokoju. W przeciwnym razie tylko dane wyjściowe. Aby utworzyć pokój, użyj |
Typ
Wycofane: użyj atrybutu SpaceType
.
Wartości w polu enum | |
---|---|
TYPE_UNSPECIFIED |
Zarezerwowane. |
ROOM |
Rozmowy między co najmniej 2 osobami. |
DM |
Czat 1:1 między człowiekiem a aplikacją do obsługi czatu, gdzie wszystkie wiadomości są płaskie. Pamiętaj, że nie dotyczy to czatów między 2 osobami. |
SpaceType
Typ pokoju. Wymagane podczas tworzenia lub aktualizowania pokoju. Dane wyjściowe tylko do innych zastosowań.
Wartości w polu enum | |
---|---|
SPACE_TYPE_UNSPECIFIED |
Zarezerwowane. |
SPACE |
Miejsce, w którym użytkownicy mogą wysyłać wiadomości, udostępniać pliki i współpracować. Element SPACE może obejmować aplikacje Google Chat. |
GROUP_CHAT |
rozmów grupowych z co najmniej 3 osobami, Element GROUP_CHAT może obejmować aplikacje Google Chat. |
DIRECT_MESSAGE |
1:1 wiadomości między 2 osobami lub człowiekiem i aplikacją Google Chat. |
SpaceThreadingState
Określa typ stanu wątku w pokoju czatu.
Wartości w polu enum | |
---|---|
SPACE_THREADING_STATE_UNSPECIFIED |
Zarezerwowane. |
THREADED_MESSAGES |
Pokoje z nazwami obsługujące wątki wiadomości. Gdy użytkownicy odpowiedzą na wiadomość, będą mogli odpowiedzieć w wątku, co zachowa zgodność z kontekstem oryginalnej wiadomości. |
GROUPED_MESSAGES |
Nazwane pokoje, w których rozmowa jest uporządkowana według tematów. Tematy i odpowiedzi na nie są grupowane. |
UNTHREADED_MESSAGES |
Czaty z dwiema osobami i rozmowy grupowe z udziałem co najmniej 3 osób. |
SpaceDetails
Informacje o pokoju, w tym opis i reguły.
Zapis JSON |
---|
{ "description": string, "guidelines": string } |
Pola | |
---|---|
description |
Opcjonalnie: Opis pokoju. Na przykład opisz temat rozmowy, przeznaczenie lub uczestników pokoju. Może mieć do 150 znaków. |
guidelines |
Opcjonalnie: Zasady, oczekiwania i etykieta Może mieć do 5000 znaków. |
HistoryState
Stan historii wiadomości i pokoi. Określa, jak długo wiadomości i wątki rozmów są przechowywane po utworzeniu.
Wartości w polu enum | |
---|---|
HISTORY_STATE_UNSPECIFIED |
Wartość domyślna. Nie używać. |
HISTORY_OFF |
Historia wyłączona. Wiadomości i wątki są przechowywane przez 24 godziny. |
HISTORY_ON |
Historia włączona. Okres przechowywania wiadomości i wątków określają reguły przechowywania w Vault obowiązujące w organizacji. |
MembershipCount
Zapis JSON |
---|
{ "joinedDirectHumanUserCount": integer, "joinedGroupCount": integer } |
Pola | |
---|---|
joinedDirectHumanUserCount |
Liczba użytkowników, którzy bezpośrednio dołączyli do pokoju, bez uwzględniania użytkowników, którzy zostali członkami grupy. |
joinedGroupCount |
Liczba wszystkich grup, które bezpośrednio dołączyły do pokoju. |
AccessSettings
Reprezentuje ustawienie dostępu do pokoju.
Zapis JSON |
---|
{
"accessState": enum ( |
Pola | |
---|---|
accessState |
Tylko dane wyjściowe. Wskazuje stan dostępu do pokoju. |
audience |
Opcjonalnie: Nazwa zasobu grupy odbiorców, która może wykryć pokój, dołączyć do pokoju i wyświetlić podgląd wiadomości w pokoju. Jeśli zasada jest nieskonfigurowana, dostęp do pokoju mają tylko użytkownicy lub Grupy dyskusyjne Google, którzy zostali indywidualnie zaproszeni lub dodani do pokoju. Więcej informacji znajdziesz w artykule Ustawianie pokoju jako wykrywalnego dla grupy odbiorców. Format: Aby użyć domyślnej grupy odbiorców w organizacji Google Workspace, ustaw wartość |
AccessState
Reprezentuje stan dostępu do pokoju.
Wartości w polu enum | |
---|---|
ACCESS_STATE_UNSPECIFIED |
Stan dostępu jest nieznany lub nieobsługiwany przez ten interfejs API. |
PRIVATE |
Tylko użytkownicy i Grupy dyskusyjne Google, którzy zostali dodani lub zaproszeni przez innych użytkowników albo administratorów Google Workspace, mogą odkryć pokój i uzyskać do niego dostęp. |
DISCOVERABLE |
Menedżer pokoju przyznał grupie odbiorców dostęp do pokoju. Użytkownicy lub Grupy dyskusyjne Google, którzy zostali indywidualnie dodani do pokoju lub zostali do niego zaproszeni, też mogą odkrywać pokój i uzyskiwać do niego dostęp. Więcej informacji znajdziesz w artykule Ustawianie pokoju jako wykrywalnego dla określonych użytkowników. |
PredefinedPermissionSettings
Ustawienia uprawnień pokoju, które możesz określić podczas tworzenia nazwanego pokoju. W przyszłości możemy dodać więcej ustawień. Szczegółowe informacje o ustawieniach uprawnień do nazwanych pokoi znajdziesz w artykule Więcej informacji o pokojach.
Wartości w polu enum | |
---|---|
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED |
Nie określono. Nie używaj. |
COLLABORATION_SPACE |
Ustawienie, dzięki któremu pokój stanie się przestrzenią współpracy, w której wszyscy użytkownicy mogą publikować wiadomości. |
ANNOUNCEMENT_SPACE |
Ustawienie, aby ten pokój stał się miejscem z ogłoszeniami, w którym tylko menedżerowie pokoju mogą publikować wiadomości. |
PermissionSettings
Ustawienia uprawnień do nazwanego pokoju. Aby skonfigurować ustawienia uprawnień podczas tworzenia pokoju, podaj w prośbie pole PredefinedPermissionSettings
.
Zapis JSON |
---|
{ "manageMembersAndGroups": { object ( |
Pola | |
---|---|
manageMembersAndGroups |
Ustawienie zarządzania użytkownikami i grupami w pokoju. |
modifySpaceDetails |
Ustawienie do aktualizowania nazwy, awatara, opisu i wytycznych pokoju. |
toggleHistory |
Ustawienie do włączania i wyłączania historii pokoju. |
useAtMentionAll |
Ustawienie używania @all w pokoju. |
manageApps |
Ustawienie zarządzania aplikacjami w pokoju. |
manageWebhooks |
Ustawienie zarządzania webhookami w pokoju. |
postMessages |
Tylko dane wyjściowe. Ustawienie publikowania wiadomości w pokoju. |
replyMessages |
Ustawienie odpowiadania na wiadomości w pokoju. |
PermissionSetting
Reprezentuje ustawienie uprawnień pokoju.
Zapis JSON |
---|
{ "managersAllowed": boolean, "membersAllowed": boolean } |
Pola | |
---|---|
managersAllowed |
Określa, czy menedżerowie pokoju mają to uprawnienie. |
membersAllowed |
Określa, czy użytkownicy, którzy nie są menedżerami, mają to uprawnienie. |
Metody |
|
---|---|
|
Wykonuje proces importowania do określonego pokoju i sprawia, że jest on widoczny dla użytkowników. |
|
Tworzy nazwany pokój. |
|
Usuwa nazwany pokój. |
|
Zwraca istniejący czat z określonym użytkownikiem. |
|
Zwraca informacje o pokoju. |
|
Wyświetla listę pokoi, do których należy rozmówca. |
|
Aktualizuje pokój. |
|
|
|
Tworzy pokój i dodaje do niego określonych użytkowników. |