Zasób: przestrzeń
Pokoju w Google Chat. Pokoje to rozmowy między co najmniej 2 użytkownikami lub wiadomości 1 na 1 między użytkownikiem a aplikacją Google Chat.
Zapis JSON |
---|
{ "name": string, "type": enum ( |
Pola | |
---|---|
name |
Identyfikator. Nazwa zasobu pokoju. Format: Gdzie |
type |
Tylko dane wyjściowe. Wycofane: użyj w zastępstwie tego |
space |
Opcjonalnie: Typ pokoju. Wymagane podczas tworzenia pokoju lub aktualizowania typu pokoju. Dane wyjściowe tylko do innych zastosowań. |
single |
Opcjonalnie: Czy pokój to czat między botem a jedną osobą. |
threaded |
Tylko dane wyjściowe. Wycofane: użyj w zastępstwie tego |
display |
Opcjonalnie: Wyświetlana nazwa pokoju. Wymagany podczas tworzenia pokoju z W przypadku czatów to pole może być puste. Obsługuje do 128 znaków. |
external |
Opcjonalnie: Niezmienna. Określa, czy ten pokój pozwala na dodawanie dowolnego użytkownika Google Chat jako członka. Dane wprowadzane podczas tworzenia pokoju w organizacji Google Workspace. Pomiń to pole podczas tworzenia pokoi w tych warunkach:
W przypadku istniejących pokoi to pole jest tylko do odczytu. |
space |
Tylko dane wyjściowe. Stan wątku w pokoju czatu. |
space |
Opcjonalnie: Szczegóły dotyczące pokoju, w tym opis i zasady. |
space |
Opcjonalnie: 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: Niezmienna. w przypadku pokoi utworzonych w Google Chat – czas utworzenia pokoju; To pole jest tylko wyjściowe, z wyjątkiem sytuacji, gdy jest używane w pomieszczeniach 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. Jest wypełniane w wyniku tylko wtedy, gdy wartość parametru |
last |
Tylko dane wyjściowe. Sygnatura czasowa ostatniej wiadomości w pokoju. |
admin |
Tylko dane wyjściowe. W przypadku pokoju czatu z aplikacją Google Chat sprawdź, czy pokój został utworzony przez administratora Google Workspace. Administratorzy mogą instalować i konfigurować czat w aplikacji Google 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ść właściwości |
access |
Opcjonalnie: Określa ustawienie dostępu pokoju. Wypełniane tylko wtedy, gdy wartość |
space |
Tylko dane wyjściowe. Identyfikator URI umożliwiający użytkownikowi dostęp do pokoju. |
import |
Tylko dane wyjściowe. Czas, w którym pokój zostanie automatycznie usunięty przez system, jeśli nadal będzie w trybie importowania. Każdy pokój utworzony w trybie importowania musi wyjść z tego trybu przed upływem tego czasu za pomocą To pole jest wypełnione tylko w przypadku pokoi utworzonych w trybie importowania. |
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 pole nie jest ustawione, tworzony jest pokój współpracy. Po utworzeniu pokoju ustawienia zostaną wypełnione w polu |
permission |
Opcjonalnie: ustawienia uprawnień pokoju w przypadku istniejących pokoi; Dane wejściowe do aktualizowania dokładnych ustawień uprawnień pokoju, w których istniejące ustawienia uprawnień są zastępowane. Wyjście zawiera listę bieżących ustawień uprawnień. |
Typ
Wycofane: użyj w zastępstwie tego 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 wiadomości na czacie między dwoma 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 wysyłają wiadomości, udostępniają pliki i współpracują. SPACE może zawierać aplikacje Google Chat. |
GROUP_CHAT |
rozmowy grupowe z co najmniej 3 osobami; GROUP_CHAT może zawierać aplikacje Google Chat. |
DIRECT_MESSAGE |
wiadomości 1:1 między dwoma osobami lub między osobą a aplikacją Google Chat; |
SpaceThreadingState
Określa typ stanu wątku w pokoju Google Chat.
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 między 2 osobami i rozmowy grupowe z 3 lub większą liczbą 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. Obsługuje do 150 znaków. |
guidelines |
Opcjonalnie: zasady, oczekiwania i etykietę obowiązujące w pokoju; Obsługuje 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 jest włączona. Reguły przechowywania Vault organizacji określają, jak długo wiadomości i wątki są przechowywane. |
MembershipCount
Reprezentuje liczbę członkostw w pokoju, pogrupowanych według kategorii.
Zapis JSON |
---|
{ "joinedDirectHumanUserCount": integer, "joinedGroupCount": integer } |
Pola | |
---|---|
joined |
Tylko dane wyjściowe. Liczba użytkowników, którzy bezpośrednio dołączyli do pokoju, bez uwzględnienia użytkowników, którzy dołączyli do pokoju jako członkowie grupy. |
joined |
Tylko dane wyjściowe. Liczba wszystkich grup, które bezpośrednio dołączyły do pokoju. |
AccessSettings
Reprezentuje ustawienie dostępu 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 znaleźć pokój, dołączyć do niego 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 w taki sposób, aby był on możliwy do znalezienia przez grupę odbiorców. Format: Aby użyć domyślnej grupy odbiorców organizacji Google Workspace, ustaw wartość Czytanie informacji o grupie odbiorców umożliwia:
To pole nie jest wypełniane, gdy używasz zakresu Aby ustawić grupę odbiorców, musisz uwierzytelnić 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, również mogą go znaleźć 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żesz określić tylko podczas tworzenia pokoju o nazwie; W przyszłości możemy dodać więcej ustawień. Szczegółowe informacje o ustawieniach uprawnień w przypadku pokoi o nazwie 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, które powoduje, że pokój staje się pokojem z ogłoszeniami, w którym tylko menedżerowie pokoju mogą publikować wiadomości. |
PermissionSettings
Ustawienia uprawnień, które możesz określić podczas aktualizowania istniejącego pokoju o nazwie.
Aby ustawić ustawienia uprawnień podczas tworzenia pokoju, w żądaniu podaj pole PredefinedPermissionSettings
.
Zapis JSON |
---|
{ "manageMembersAndGroups": { object ( |
Pola | |
---|---|
manage |
Opcjonalnie: Ustawienie dotyczące zarządzania użytkownikami i grupami w pokoju. |
modify |
Opcjonalnie: Ustawienie umożliwiające aktualizowanie nazwy pokoju, awatara, opisu i wytycznych. |
toggle |
Opcjonalnie: Ustawienie włączania i wyłączania historii pokoju. |
use |
Opcjonalnie: Ustawienie dotyczące używania polecenia @all w pokoju |
manage |
Opcjonalnie: Ustawienie zarządzania aplikacjami w pokoju. |
manage |
Opcjonalnie: Ustawienie zarządzania webhookami w pokoju. |
post |
Tylko dane wyjściowe. Ustawienie dotyczące publikowania wiadomości w pokoju. |
reply |
Opcjonalnie: Ustawienie odpowiadania na wiadomości w pokoju. |
PermissionSetting
Reprezentuje ustawienie uprawnień pokoju.
Zapis JSON |
---|
{ "managersAllowed": boolean, "membersAllowed": boolean } |
Pola | |
---|---|
managers |
Opcjonalnie: czy menedżerowie pokoju mają to uprawnienie. |
members |
Opcjonalnie: 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. |
|
usuwa pokój nazwany; |
|
Zwraca istniejące bezpośrednie wiadomości z określonym użytkownikiem. |
|
Zwraca szczegóły pokoju. |
|
Lista pokoi, których użytkownik jest członkiem. |
|
Aktualizuje pokój. |
|
Zwraca listę pokoi w organizacji Google Workspace na podstawie wyszukiwania administratora. |
|
Tworzy pokój i dodaje do niego określonych użytkowników. |