REST Resource: spaces

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ą do czatu.

Zapis JSON 
{
  "name": string,
  "type": enum (Type),
  "spaceType": enum (SpaceType),
  "singleUserBotDm": boolean,
  "threaded": boolean,
  "displayName": string,
  "externalUserAllowed": boolean,
  "spaceThreadingState": enum (SpaceThreadingState),
  "spaceDetails": {
    object (SpaceDetails)
  },
  "spaceHistoryState": enum (HistoryState),
  "importMode": boolean,
  "createTime": string,
  "lastActiveTime": string,
  "adminInstalled": boolean,
  "membershipCount": {
    object (MembershipCount)
  },
  "accessSettings": {
    object (AccessSettings)
  },
  "spaceUri": string,
  "customer": string,

  // Union field space_permission_settings can be only one of the following:
  "predefinedPermissionSettings": enum (PredefinedPermissionSettings),
  "permissionSettings": {
    object (PermissionSettings)
  }
  // End of list of possible types for union field space_permission_settings.
}
Pola
name

string

Identyfikator. Nazwa zasobu pokoju.

Format: spaces/{space}

Gdzie {space} to identyfikator pokoju przypisany przez system. Identyfikator pokoju możesz uzyskać, wywołując metodę spaces.list() lub korzystając z adresu URL pokoju. Jeśli na przykład adres URL pokoju to https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA, jego identyfikator to AAAAAAAAA.
type
(deprecated)

enum (Type)

Tylko dane wyjściowe. Wycofane: użyj w zastępstwie zasady spaceType. Typ pokoju.
spaceType

enum (SpaceType)

Opcjonalnie: Typ pokoju. Wymagane podczas tworzenia pokoju lub aktualizowania typu pokoju. Dane wyjściowe tylko do innych zastosowań.
singleUserBotDm

boolean

Opcjonalnie: Określa, czy pokój jest czatem między aplikacją Google Chat a jednym człowiekiem.
threaded
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj atrybutu spaceThreadingState. czy wiadomości są w tym pokoju w wątkach.
displayName

string

Opcjonalnie: Wyświetlana nazwa pokoju. Wymagana podczas tworzenia pokoju z spaceType o wartości SPACE. Jeśli podczas tworzenia pokoju lub aktualizowania pokoju displayName zobaczysz komunikat o błędzie ALREADY_EXISTS, spróbuj użyć innego elementu displayName. Istniejący pokój w organizacji Google Workspace może już używać tej wyświetlanej nazwy.

W przypadku czatów to pole może być puste.

Może mieć do 128 znaków.
externalUserAllowed

boolean

Opcjonalnie: Niezmienna. 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 przypadkach:

  • Użytkownik uwierzytelniony korzysta z konta klienta (niezarządzanego konta użytkownika). Domyślnie w pokoju utworzonym przez konto dla użytkowników indywidualnych zezwala każdy użytkownik Google Chat.

W przypadku dotychczasowych pokoi to pole zawiera tylko dane wyjściowe.
spaceThreadingState

enum (SpaceThreadingState)

Tylko dane wyjściowe. Stan wątku w pokoju czatu.
spaceDetails

object (SpaceDetails)

Opcjonalnie: Informacje o pokoju, w tym opis i reguły.
spaceHistoryState

enum (HistoryState)

Opcjonalnie: Stan historii wiadomości dla wiadomości i wątków w tym pokoju.
importMode

boolean

Opcjonalnie: Określa, czy ten pokój został utworzony w usłudze Import Mode w ramach migracji danych do Google Workspace. Podczas importowania pokoi nie są one widoczne dla użytkowników, dopóki import się nie zakończy.

Utworzenie pokoju w domenie Import Mode wymaga uwierzytelniania użytkownika.
createTime

string (Timestamp format)

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.

Wartość podawana w danych wyjściowych tylko wtedy, gdy spaceType ma wartość GROUP_CHAT lub SPACE.
lastActiveTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniej wiadomości w pokoju.
adminInstalled

boolean

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 Google Chat w imieniu użytkowników w organizacji.

Aby instalacja była obsługiwana przez administratora, aplikacja Google Chat musi obsługiwać czat.
membershipCount

object (MembershipCount)

Tylko dane wyjściowe. Liczba wspierających pogrupowanych według typu wspierającego. Wartość wypełniana, gdy spaceType ma wartość SPACE, DIRECT_MESSAGE lub GROUP_CHAT.
accessSettings

object (AccessSettings)

Opcjonalnie: Określa ustawienie dostępu do pokoju. Wypełniane tylko wtedy, gdy wartość spaceType to SPACE.
spaceUri

string

Tylko dane wyjściowe. Identyfikator URI umożliwiający użytkownikowi dostęp do pokoju.
customer

string

Opcjonalnie: Stały. Identyfikator klienta domeny pokoju. Wymagane tylko podczas tworzenia pokoju z uwierzytelnianiem aplikacji, w którym SpaceType ma wartość SPACE. W przeciwnym razie nie należy go ustawiać.

W formacie customers/{customer}, gdzie customer to id z [zasobu klienta w Admin SDK](https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Aplikacje prywatne mogą też używać aliasu customers/my_customer do tworzenia przestrzeni w tej samej organizacji Google Workspace, co aplikacja.

W przypadku czatów to pole nie jest wypełniane.

Pole unii space_permission_settings. Reprezentuje ustawienia uprawnień pokoju. Wartość jest podawana tylko wtedy, gdy space_type ma wartość SPACE.

Wymaga uwierzytelniania użytkownika. space_permission_settings może mieć tylko jedną z tych wartości:
predefinedPermissionSettings

enum (PredefinedPermissionSettings)

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 PermissionSettings.
permissionSettings

object (PermissionSettings)

Opcjonalnie: Ustawienia uprawnień dla istniejących pokoi. Dane wejściowe do aktualizowania dokładnych ustawień uprawnień pokoju, w których zastępuje się dotychczasowe ustawienia uprawnień. 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ą 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 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; Element GROUP_CHAT może obejmować 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 Google Chat.

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 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

Informacje o pokoju, w tym opis i reguły.

Zapis JSON 
{
  "description": string,
  "guidelines": string
}
Pola
description

string

Opcjonalnie: Opis pokoju. Możesz na przykład opisać temat dyskusji, cel lub uczestników pokoju.

Może mieć do 150 znaków.
guidelines

string

Opcjonalnie: Zasady, oczekiwania i etykieta

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 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
joinedDirectHumanUserCount

integer

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.
joinedGroupCount

integer

Tylko dane wyjściowe. Liczba wszystkich grup, które bezpośrednio dołączyły do pokoju.

AccessSettings

Reprezentuje ustawienie dostępu do pokoju.

Zapis JSON 
{
  "accessState": enum (AccessState),
  "audience": string
}
Pola
accessState

enum (AccessState)

Tylko dane wyjściowe. Wskazuje stan dostępu do pokoju.
audience

string

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 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 dostępnego dla grupy odbiorców.

Format: audiences/{audience}

Aby użyć domyślnej grupy odbiorców organizacji Google Workspace, ustaw wartość audiences/default.

Czytanie informacji o grupie odbiorców umożliwia:

To pole nie jest wypełniane, gdy używasz zakresu chat.bot z uwierzytelnianiem aplikacji.

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 przez ten interfejs 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ó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 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, dzięki któremu pokój stanie się przestrzenią współpracy, w której 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 (PermissionSetting)
  },
  "modifySpaceDetails": {
    object (PermissionSetting)
  },
  "toggleHistory": {
    object (PermissionSetting)
  },
  "useAtMentionAll": {
    object (PermissionSetting)
  },
  "manageApps": {
    object (PermissionSetting)
  },
  "manageWebhooks": {
    object (PermissionSetting)
  },
  "postMessages": {
    object (PermissionSetting)
  },
  "replyMessages": {
    object (PermissionSetting)
  }
}
Pola
manageMembersAndGroups

object (PermissionSetting)

Opcjonalnie: Ustawienie zarządzania użytkownikami i grupami w pokoju.
modifySpaceDetails

object (PermissionSetting)

Opcjonalnie: Ustawienie do aktualizowania nazwy, awatara, opisu i wytycznych pokoju.
toggleHistory

object (PermissionSetting)

Opcjonalnie: Ustawienie włączania i wyłączania historii pokoju.
useAtMentionAll

object (PermissionSetting)

Opcjonalnie: Ustawienie dotyczące używania polecenia @all w pokoju
manageApps

object (PermissionSetting)

Opcjonalnie: Ustawienie zarządzania aplikacjami w pokoju.
manageWebhooks

object (PermissionSetting)

Opcjonalnie: Ustawienie zarządzania webhookami w pokoju.
postMessages

object (PermissionSetting)

Tylko dane wyjściowe. Ustawienie publikowania wiadomości w pokoju.
replyMessages

object (PermissionSetting)

Opcjonalnie: Ustawienie odpowiadania na wiadomości w pokoju.

PermissionSetting

Reprezentuje ustawienie uprawnień pokoju.

Zapis JSON 
{
  "managersAllowed": boolean,
  "membersAllowed": boolean
}
Pola
managersAllowed

boolean

Opcjonalnie: Określa, czy menedżerowie pokoju mają to uprawnienie.
membersAllowed

boolean

Opcjonalnie: Określa, czy użytkownicy, którzy nie są menedżerami, mają to uprawnienie.

Metody

completeImport

 Zakończy proces importowania w przypadku wybranego pokoju i sprawi, że będzie on widoczny dla użytkowników.

create

 tworzy pokój bez użytkowników;

delete

 usuwa pokój nazwany;

findDirectMessage

 Zwraca istniejący czat z określonym użytkownikiem.

get

 Zwraca informacje o pokoju.

list

 Wyświetla listę pokoi, do których należy rozmówca.

patch

 Aktualizuje pokój.
Zwraca listę pokoi w organizacji Google Workspace na podstawie wyszukiwania przeprowadzonego przez administratora.

setup

 Tworzy pokój i dodaje do niego określonych użytkowników.