Ресурс: Космос
Место в 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, — время создания пространства. Это поле предназначено только для вывода, за исключением случаев, когда оно используется в пространствах режима импорта. Для пространств режима импорта установите в этом поле историческую временную метку создания пространства в источнике, чтобы сохранить исходное время создания. Заполняется в выходных данных только в том случае, если |
adminInstalled | Только вывод. Установлено ли приложение Chat администратором Google Workspace. Администраторы могут установить приложение Chat для своего домена, организационного подразделения или группы пользователей. Администраторы могут устанавливать приложения чата только для прямого обмена сообщениями между пользователями и приложением. Чтобы поддерживать установку администратора, ваше приложение должно поддерживать прямой обмен сообщениями. |
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-представление |
---|
{
"accessState": enum ( |
Поля | |
---|---|
accessState | Только вывод. Указывает состояние доступа к пространству. |
audience | Необязательный. Имя ресурса целевой аудитории , которая может получить доступ к пространству. Задайте в этом поле действительный идентификатор целевой аудитории, чтобы сделать пространство доступным для обнаружения, или используйте псевдоним |
Аксессстате
Представляет состояние доступа к пространству.
Перечисления | |
---|---|
ACCESS_STATE_UNSPECIFIED | Состояние доступа неизвестно или не поддерживается в этом API. |
PRIVATE | Пространство доступно добавленным или приглашенным участникам или группам. |
DISCOVERABLE | Пространство доступно выбранной целевой аудитории , а также добавленным или приглашенным участникам или группам. |
Методы | |
---|---|
| Завершает процесс импорта указанного пространства и делает его видимым для пользователей. |
| Создает именованное пространство. |
| Удаляет именованное пространство. |
| Возвращает существующее прямое сообщение указанному пользователю. |
| Возвращает подробную информацию о пространстве. |
| Перечисляет пространства, членом которых является вызывающий абонент. |
| Обновляет пространство. |
| Создает пространство и добавляет в него указанных пользователей. |