Ресурс: Космос
Место в Google Chat. Пространства — это разговоры между двумя или более пользователями или сообщения один на один между пользователем и приложением чата.
JSON-представление |
---|
{ "name": string, "type": enum ( |
Поля | |
---|---|
name | Имя ресурса пространства. Формат: |
type | Только вывод. Устарело: вместо этого используйте |
spaceType | Тип помещения. Требуется при создании пространства или обновлении типа пространства. Вывод только для другого использования. |
singleUserBotDm | Необязательный. Является ли пространство личным сообщением между приложением чата и одним человеком. |
threaded | Только вывод. Устарело: вместо этого используйте |
displayName | Отображаемое имя пространства. Требуется при создании пространства . Если вы получаете сообщение об ошибке Для прямых сообщений это поле может быть пустым. Поддерживает до 128 символов. |
externalUserAllowed | Неизменный. Разрешается ли в этом пространстве любому пользователю Google Chat быть участником. Ввод при создании пространства в организации Google Workspace. Пропустите это поле при создании пространств в следующих условиях:
Для существующих пространств это поле предназначено только для вывода. |
spaceThreadingState | Только вывод. Состояние потока в пространстве чата. |
spaceDetails | Подробная информация о пространстве, включая описание и правила. |
spaceHistoryState | Состояние истории сообщений и потоков в этом пространстве. |
importMode | Необязательный. Создано ли это пространство в |
createTime | Необязательный. Неизменный. Для пространств, созданных в Chat, — время создания пространства. Это поле предназначено только для вывода, за исключением случаев, когда оно используется в пространствах режима импорта. Для пространств режима импорта установите в этом поле историческую временную метку создания пространства в источнике, чтобы сохранить исходное время создания. Заполняется в выходных данных только в том случае, если |
lastActiveTime | Только вывод. Временная метка последнего сообщения в пространстве. |
adminInstalled | Только вывод. Для пространств прямого обмена сообщениями (DM) с приложением Chat: было ли пространство создано администратором Google Workspace. Администраторы могут установить и настроить прямое сообщение с помощью приложения Chat от имени пользователей в своей организации. Чтобы поддерживать установку администратора, ваше приложение Chat должно поддерживать прямой обмен сообщениями. |
membershipCount | Только вывод. Количество присоединившихся участников, сгруппированных по типу участников. Заполняется, когда |
accessSettings | Необязательный. Указывает настройки доступа к пространству. Заполняется только в том случае, если |
spaceUri | Только вывод. URI пространства. |
Тип
Устарело: вместо этого используйте SpaceType
.
Перечисления | |
---|---|
TYPE_UNSPECIFIED | Сдержанный. |
ROOM | Разговоры между двумя и более людьми. |
DM | 1:1 Прямое сообщение между человеком и приложением чата, где все сообщения однородны. Обратите внимание, что сюда не входят прямые сообщения между двумя людьми. |
Тип пространства
Тип помещения. Требуется при создании или обновлении пространства. Вывод только для другого использования.
Перечисления | |
---|---|
SPACE_TYPE_UNSPECIFIED | Сдержанный. |
SPACE | Место, где люди отправляют сообщения, обмениваются файлами и сотрудничают. SPACE может включать в себя приложения чата. |
GROUP_CHAT | Групповые беседы между 3 и более людьми. GROUP_CHAT может включать приложения чата. |
DIRECT_MESSAGE | Сообщения 1:1 между двумя людьми или человеком и приложением чата. |
SpaceThreadingState
Указывает тип состояния потока в пространстве чата.
Перечисления | |
---|---|
SPACE_THREADING_STATE_UNSPECIFIED | Сдержанный. |
THREADED_MESSAGES | Именованные пространства, поддерживающие потоки сообщений. Когда пользователи отвечают на сообщение, они могут ответить в цепочке, что сохраняет их ответ в контексте исходного сообщения. |
GROUPED_MESSAGES | Именованные пространства, где беседа организована по темам. Темы и ответы на них сгруппированы вместе. |
UNTHREADED_MESSAGES | Прямые сообщения (DM) между двумя людьми и групповые беседы между 3 или более людьми. |
ПространствоДетали
Подробная информация о пространстве, включая описание и правила.
JSON-представление |
---|
{ "description": string, "guidelines": string } |
Поля | |
---|---|
description | Необязательный. Описание помещения. Например, опишите тему обсуждения, функциональное назначение или участников пространства. Поддерживает до 150 символов. |
guidelines | Необязательный. Правила, ожидания и этикет этого места. Поддерживает до 5000 символов. |
Состояние истории
Состояние истории сообщений и пространств. Указывает, как долго сообщения и цепочки разговоров хранятся после создания.
Перечисления | |
---|---|
HISTORY_STATE_UNSPECIFIED | Значение по умолчанию. Не использовать. |
HISTORY_OFF | История отключена. Сообщения и темы хранятся 24 часа . |
HISTORY_ON | История включена. Правила хранения в Сейфе организации определяют, как долго хранятся сообщения и цепочки. |
ЧленствоКаунт
Представляет количество участников пространства, сгруппированных по категориям.
JSON-представление |
---|
{ "joinedDirectHumanUserCount": integer, "joinedGroupCount": integer } |
Поля | |
---|---|
joinedDirectHumanUserCount | Подсчет пользователей-людей, которые напрямую присоединились к пространству, не считая пользователей, присоединившихся путем членства в присоединенной группе. |
joinedGroupCount | Подсчет всех групп, которые напрямую присоединились к пространству. |
Доступ к настройкам
Представляет настройки доступа к пространству.
JSON-представление |
---|
{
"accessState": enum ( |
Поля | |
---|---|
accessState | Только вывод. Указывает состояние доступа к пространству. |
audience | Необязательный. Имя ресурса целевой аудитории , которая может получить доступ к пространству. Задайте в этом поле действительный идентификатор целевой аудитории, чтобы сделать пространство доступным для обнаружения, или используйте псевдоним |
Аксессстате
Представляет состояние доступа к пространству.
Перечисления | |
---|---|
ACCESS_STATE_UNSPECIFIED | Состояние доступа неизвестно или не поддерживается в этом API. |
PRIVATE | Пространство доступно добавленным или приглашенным участникам или группам. |
DISCOVERABLE | Пространство доступно выбранной целевой аудитории , а также добавленным или приглашенным участникам или группам. |
Методы | |
---|---|
| Завершает процесс импорта указанного пространства и делает его видимым для пользователей. |
| Создает именованное пространство. |
| Удаляет именованное пространство. |
| Возвращает существующее прямое сообщение указанному пользователю. |
| Возвращает подробную информацию о пространстве. |
| Перечисляет пространства, членом которых является вызывающий абонент. |
| Обновляет пространство. |
| |
| Создает пространство и добавляет в него указанных пользователей. |