Zasób: przestrzeń
Pokoju 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: Gdzie |
type |
Tylko dane wyjściowe. Wycofane: użyj atrybutu |
space |
Typ pokoju. Wymagane podczas tworzenia pokoju lub aktualizowania typu pokoju. Dane wyjściowe tylko do innych zastosowań. |
single |
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 w zastępstwie zasady |
display |
Wyświetlana nazwa pokoju. Wymagane podczas tworzenia pokoju z ustawieniem W przypadku czatów to pole może być puste. Może mieć do 128 znaków. |
external |
Niezmienna. Określa, czy ten pokój pozwala na dołączenie dowolnego użytkownika Google Chat. Dane wprowadzane podczas tworzenia pokoju w organizacji Google Workspace. Pomiń to pole podczas tworzenia pokoi w tych przypadkach:
W przypadku istniejących pokoi to pole jest tylko do odczytu. |
space |
Tylko dane wyjściowe. Stan wątku w pokoju czatu. |
space |
Informacje o pokoju, w tym opis i reguły. |
space |
stan historii wiadomości i wątków w tym pokoju; |
import |
Opcjonalnie: Czy ten pokój został utworzony w Tworzenie pokoju w |
create |
Opcjonalnie: Stała. 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 to pole na historyczny znacznik czasu, w którym pokój został utworzony w źródle, aby zachować pierwotny czas utworzenia. Wartość podawana w danych wyjściowych tylko wtedy, gdy |
last |
Tylko dane wyjściowe. Sygnatura czasowa ostatniej wiadomości w pokoju. |
admin |
Tylko dane wyjściowe. W przypadku czatów z poziomu aplikacji Google Chat określ, czy pokój został utworzony przez administratora Google Workspace. Administratorzy mogą instalować i konfigurować czat w aplikacji Chat w imieniu użytkowników w organizacji. Aby umożliwić instalację przez administratora, aplikacja Google Chat musi obsługiwać wiadomości bezpośrednie. |
membership |
Tylko dane wyjściowe. Liczba wspierających pogrupowanych według typu wspierającego. Wypełniane, gdy wartość |
access |
Opcjonalnie: Określa ustawienie dostępu do pokoju. Wartość jest podawana tylko wtedy, gdy |
space |
Tylko dane wyjściowe. Identyfikator URI umożliwiający użytkownikowi dostęp do pokoju. |
customer |
Opcjonalnie: Niezmienna. Identyfikator klienta domeny pokoju. Wymagane tylko podczas tworzenia pokoju z uwierzytelnianiem aplikacji i wartością W formacie W przypadku czatów to pole nie jest wypełniane. |
Pole unii Wymaga uwierzytelniania użytkownika. |
|
predefined |
Opcjonalnie: Tylko dane wejściowe. wstępnie zdefiniowane ustawienia uprawnień pokoju, które można określić tylko podczas tworzenia pokoju; Jeśli to pole nie jest skonfigurowane, tworzony jest pokój współpracy. Po utworzeniu pokoju ustawienia zostaną wypełnione w polu |
permission |
Opcjonalnie: Ustawienia uprawnień dla istniejących pokoi. Pole do aktualizowania dokładnych ustawień uprawnień dotyczących pokoju. Obecne ustawienia uprawnień są zastępowane. Dane wyjściowe zawierają listę bieżących ustawień uprawnień. |
Typ
Wycofane: użyj atrybutu SpaceType
.
Wartości w polu enum | |
---|---|
TYPE_UNSPECIFIED |
Zarezerwowane. |
ROOM |
Rozmowy między co najmniej 2 osobami. |
DM |
Czat indywidualny między człowiekiem a aplikacją do obsługi czatu, w którym wszystkie wiadomości są równe. 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ć. SPACE może zawierać aplikacje Google Chat. |
GROUP_CHAT |
rozmowy grupowe z 3 lub większą liczbą uczestników. GROUP_CHAT może zawierać aplikacje Google Chat. |
DIRECT_MESSAGE |
wiadomości 1:1 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 |
Nazwane pokoje, które obsługują wątki wiadomości. Gdy użytkownicy odpowiadają na wiadomość, mogą to zrobić w wątku, dzięki czemu ich odpowiedź będzie miała kontekst oryginalnej wiadomości. |
GROUPED_MESSAGES |
Nazwane pokoje, w których rozmowy są uporządkowane według tematu. 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
Szczegóły dotyczące pokoju, w tym opis i zasady.
Zapis JSON |
---|
{ "description": string, "guidelines": string } |
Pola | |
---|---|
description |
Opcjonalnie: Opis pokoju. Możesz na przykład opisać temat dyskusji, cel lub uczestników pokoju. Może mieć do 150 znaków. |
guidelines |
Opcjonalnie: zasady, oczekiwania i etykietę obowiązujące w pokoju; Obsługuje maksymalnie 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
Reprezentuje liczbę członkostw w pokoju, pogrupowanych według kategorii.
Zapis JSON |
---|
{ "joinedDirectHumanUserCount": integer, "joinedGroupCount": integer } |
Pola | |
---|---|
joined |
Liczba użytkowników, którzy bezpośrednio dołączyli do pokoju, bez uwzględniania użytkowników, którzy zostali członkami grupy. |
joined |
Liczba wszystkich grup, które bezpośrednio dołączyły do pokoju. |
AccessSettings
Reprezentuje ustawienie dostępu do pokoju.
Zapis JSON |
---|
{
"accessState": enum ( |
Pola | |
---|---|
access |
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 nie jest ustawiona, dostęp do pokoju mają tylko użytkownicy lub grupy dyskusyjne Google, które zostały zaproszone indywidualnie lub dodane 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ść Odczytywanie odbiorców docelowych pomaga:
To pole nie jest wypełniane, gdy używasz zakresu Ustawienie grupy odbiorców wymaga uwierzytelniania użytkownika. |
AccessState
Reprezentuje stan dostępu do pokoju.
Wartości w polu enum | |
---|---|
ACCESS_STATE_UNSPECIFIED |
Stan dostępu jest nieznany lub nieobsługiwany w tym interfejsie API. |
PRIVATE |
Dostęp do pokoju mają tylko użytkownicy lub grupy dyskusyjne Google, którzy zostali dodani indywidualnie lub zaproszeni przez innych użytkowników albo administratorów Google Workspace. |
DISCOVERABLE |
Menedżer pokoju przyznał grupie odbiorców dostęp do pokoju. Użytkownicy lub grupy dyskusyjne Google, które zostały dodane indywidualnie lub zaproszone do pokoju, mogą również znaleźć pokój i uzyskać do niego dostęp. Więcej informacji znajdziesz w artykule Ustawianie pokoju jako możliwego do znalezienia dla określonych użytkowników. Tworzenie pokoi możliwych do znalezienia wymaga uwierzytelniania użytkownika. |
PredefinedPermissionSettings
Wstępnie zdefiniowane ustawienia uprawnień, które można określić tylko 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, które powoduje, że pokój staje się miejscem współpracy, w którym 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ń, które można określić podczas aktualizowania istniejącego pokoju nazwanego.
Aby ustawić ustawienia uprawnień podczas tworzenia pokoju, w żądaniu podaj pole PredefinedPermissionSettings
.
Zapis JSON |
---|
{ "manageMembersAndGroups": { object ( |
Pola | |
---|---|
manage |
Ustawienie dotyczące zarządzania użytkownikami i grupami w pokoju. |
modify |
Ustawienie umożliwiające aktualizowanie nazwy pokoju, awatara, opisu i wytycznych. |
toggle |
Ustawienie włączania i wyłączania historii pokoju. |
use |
Ustawienie dotyczące używania polecenia @all w pokoju |
manage |
Ustawienie zarządzania aplikacjami w pokoju. |
manage |
Ustawienie zarządzania webhookami w pokoju. |
post |
Tylko dane wyjściowe. Ustawienie dotyczące publikowania wiadomości w pokoju. |
reply |
Ustawienie odpowiadania na wiadomości w pokoju. |
PermissionSetting
Reprezentuje ustawienie uprawnień pokoju.
Zapis JSON |
---|
{ "managersAllowed": boolean, "membersAllowed": boolean } |
Pola | |
---|---|
managers |
czy menedżerowie pokoju mają to uprawnienie. |
members |
Określa, czy użytkownicy, którzy nie są menedżerami, mają to uprawnienie. |
Metody |
|
---|---|
|
Zakończy proces importowania w przypadku wybranego pokoju i sprawi, że będzie on widoczny dla użytkowników. |
|
Tworzy pokój bez użytkowników. |
|
usuwa pokój nazwany; |
|
Zwraca istniejący czat z określonym użytkownikiem. |
|
Zwraca szczegóły pokoju. |
|
Wyświetla listę pokoi, do których należy rozmówca. |
|
Aktualizuje pokój. |
|
Zwraca listę pokoi w organizacji Google Workspace na podstawie wyszukiwania przeprowadzonego przez administratora. |
|
Tworzy pokój i dodaje do niego określonych użytkowników. |