- Ресурс: Космос
 - Методы
 
Ресурс: Космос
Пространство в Google Chat. Пространства — это беседы между двумя или более пользователями или сообщения 1:1 между пользователем и приложением Chat.
| JSON-представление | 
|---|
{ "name": string, "type": enum (  | 
| Поля | |
|---|---|
 name |   Идентификатор. Имя ресурса пространства.  Формат:   Где   | 
 type |    Только вывод. Устарело: используйте   | 
 spaceType |   Необязательно. Тип пространства. Требуется при создании пространства или обновлении его типа. Выводится только для другого использования.  | 
 singleUserBotDm |   Необязательно. Является ли это личным сообщением между приложением чата и одним человеком.  | 
 threaded |    Только вывод. Устарело: используйте   | 
 displayName |    Необязательно. Отображаемое имя пространства. Требуется при создании пространства с  Для прямых сообщений это поле может быть пустым. Поддерживает до 128 символов.  | 
 externalUserAllowed |   Необязательно. Неизменяемо. Разрешает ли это пространство любому пользователю Google Chat быть участником. Указывается при создании пространства в организации Google Workspace. Пропускайте это поле при создании пространств в следующих случаях: 
 Для существующих пространств это поле предназначено только для вывода.  | 
 spaceThreadingState |   Только вывод. Состояние потока в пространстве чата.  | 
 spaceDetails |   Необязательно. Подробная информация о пространстве, включая описание и правила.  | 
 spaceHistoryState |   Необязательно. Состояние истории сообщений и обсуждений в этом разделе.  | 
 importMode |    Необязательно. Создано ли это пространство в   Создание пространства в   | 
 createTime |   Необязательное. Неизменяемое. Для пространств, созданных в чате, время создания. Это поле только для вывода, за исключением случаев использования в пространствах в режиме импорта. Для пространств в режиме импорта задайте в этом поле историческую временную метку, когда пространство было создано в источнике, чтобы сохранить исходное время создания.  Заполняется в выходных данных только в том случае, если   | 
 lastActiveTime |   Только вывод. Временная метка последнего сообщения в пространстве.  | 
 adminInstalled |   Только вывод. Для пространств прямых сообщений (DM) с приложением Chat: было ли пространство создано администратором Google Workspace. Администраторы могут установить и настроить функцию прямых сообщений с приложением Chat от имени пользователей своей организации. Для поддержки установки администратором ваше приложение чата должно поддерживать функцию прямого обмена сообщениями.  | 
 membershipCount |    Только вывод. Количество присоединённых участников, сгруппированных по типу участника. Заполняется, если   | 
 accessSettings |    Необязательно. Задаёт настройки доступа к пространству. Заполняется только если   | 
 spaceUri |   Только вывод. URI для доступа пользователя к пространству.  | 
 importModeExpireTime |   Только вывод. Время, через которое пространство будет автоматически удалено системой, если оно остаётся в режиме импорта.  Каждое пространство, созданное в режиме импорта, должно выйти из этого режима до истечения указанного времени с помощью  Это поле заполняется только для пространств, созданных в режиме импорта.  | 
 customer |    Необязательный. Неизменяемый. Идентификатор клиента домена пространства. Требуется только при создании пространства с аутентификацией приложения , если   В формате  Это поле не заполняется для прямых сообщений (DM) или когда пространство создается пользователями, не являющимися пользователями Google Workspace.  | 
 Поле объединения space_permission_settings . Представляет настройки разрешений пространства. Заполняется только если space_type — SPACE . space_permission_settings может принимать только одно из следующих значений: | |
 predefinedPermissionSettings |    Необязательно. Только ввод. Предустановленные настройки разрешений для пространства, ввод только при его создании. Если поле не заполнено, создается пространство для совместной работы. После создания пространства настройки заполняются в поле  Настройка предопределенных параметров разрешений поддерживает: 
  | 
 permissionSettings |   Необязательно. Настройки разрешений для существующих пространств. Входные данные для обновления точных настроек разрешений для пространств, при которых существующие настройки разрешений заменяются. Выходные данные содержат список текущих настроек разрешений. Чтение и обновление настроек разрешений поддерживает: 
  | 
Тип
 Устарело: вместо этого используйте SpaceType . 
| Перечисления | |
|---|---|
 TYPE_UNSPECIFIED | Сдержанный. | 
 ROOM | Разговоры между двумя или более людьми. | 
 DM | Прямые сообщения 1:1 между человеком и чат-приложением, где все сообщения являются однородными. Обратите внимание, что сюда не входят прямые сообщения между двумя людьми. | 
SpaceType
Тип пространства. Требуется при создании или обновлении пространства. Выводится только для другого использования.
| Перечисления | |
|---|---|
 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 и более людьми. | 
SpaceDetails
Подробная информация о пространстве, включая описание и правила.
| JSON-представление | 
|---|
{ "description": string, "guidelines": string }  | 
| Поля | |
|---|---|
 description |   Необязательно. Описание пространства. Например, опишите тему обсуждения, функциональное назначение или участников. Поддерживает до 150 символов.  | 
 guidelines |   Необязательно. Правила, ожидания и этикет, действующие в этом пространстве. Поддерживает до 5000 символов.  | 
ИсторияГосударство
Состояние истории сообщений и чат-групп. Определяет, как долго хранятся сообщения и цепочки сообщений после создания.
| Перечисления | |
|---|---|
 HISTORY_STATE_UNSPECIFIED | Значение по умолчанию. Не использовать. | 
 HISTORY_OFF | История отключена. Сообщения и обсуждения хранятся 24 часа . | 
 HISTORY_ON | История включена. Правила хранения в Хранилище организации определяют срок хранения сообщений и цепочек сообщений. | 
MembershipCount
Представляет собой количество участников пространства, сгруппированных по категориям.
| JSON-представление | 
|---|
{ "joinedDirectHumanUserCount": integer, "joinedGroupCount": integer }  | 
| Поля | |
|---|---|
 joinedDirectHumanUserCount |   Только вывод. Количество пользователей, которые напрямую присоединились к пространству, без учёта пользователей, присоединившихся через членство в уже существующей группе.  | 
 joinedGroupCount |   Только вывод. Количество всех групп, напрямую присоединившихся к пространству.  | 
Настройки доступа
Представляет собой настройку доступа к пространству.
| JSON-представление | 
|---|
{
  "accessState": enum ( | 
| Поля | |
|---|---|
 accessState |   Только вывод. Указывает состояние доступа к пространству.  | 
 audience |   Необязательно. Имя ресурса целевой аудитории , которая может находить пространство, присоединяться к нему и просматривать сообщения в пространстве. Если не задано, доступ к пространству будут иметь только пользователи или группы Google, которые были индивидуально приглашены или добавлены в него. Подробнее см. в разделе «Как сделать пространство видимым для целевой аудитории» .  Формат:   Чтобы использовать целевую аудиторию по умолчанию для организации Google Workspace, задайте значение  Чтение целевой аудитории поддерживает: 
  Это поле не заполняется при использовании области действия  Для настройки целевой аудитории требуется аутентификация пользователя .  | 
AccessState
Представляет состояние доступа к пространству.
| Перечисления | |
|---|---|
 ACCESS_STATE_UNSPECIFIED | Состояние доступа неизвестно или не поддерживается в этом API. | 
 PRIVATE | Обнаружить пространство и получить к нему доступ могут только пользователи или группы Google, индивидуально добавленные или приглашенные другими пользователями или администраторами Google Workspace. | 
 DISCOVERABLE | Менеджер пространства предоставил целевой аудитории доступ к пространству. Пользователи или группы Google, добавленные или приглашенные в пространство по отдельности, также могут находить его и получать к нему доступ. Подробнее см. в статье «Как сделать пространство доступным для обнаружения определёнными пользователями» . Создание обнаруживаемых пространств требует аутентификации пользователя .  | 
ПредопределенныеНастройкиРазрешений
Предопределенные настройки разрешений, которые можно указать только при создании именованного пространства. В будущем могут быть добавлены дополнительные настройки. Подробнее о настройках разрешений для именованных пространств см. в разделе «Подробнее о пространствах» .
| Перечисления | |
|---|---|
 PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED | Не указано. Не использовать. | 
 COLLABORATION_SPACE | Настройка пространства для совместной работы, где все участники могут публиковать сообщения. | 
 ANNOUNCEMENT_SPACE | Настройка пространства как пространства для объявлений, где публиковать сообщения могут только менеджеры пространства. | 
Настройки разрешений
Настройки разрешений , которые можно указать при обновлении существующего именованного пространства.
 Чтобы задать параметры разрешений при создании пространства, укажите поле PredefinedPermissionSettings в своем запросе. 
| JSON-представление | 
|---|
{ "manageMembersAndGroups": { object (  | 
| Поля | |
|---|---|
 manageMembersAndGroups |   Необязательно. Настройка для управления участниками и группами в пространстве.  | 
 modifySpaceDetails |   Необязательно. Настройка обновления названия пространства, аватара, описания и правил.  | 
 toggleHistory |   Необязательно. Настройка включения и выключения истории пространства.  | 
 useAtMentionAll |   Необязательно. Настройка для использования @all в пространстве.  | 
 manageApps |   Необязательно. Настройка для управления приложениями в пространстве.  | 
 manageWebhooks |   Необязательно. Настройка для управления веб-перехватами в пространстве.  | 
 postMessages |   Только вывод. Настройка для публикации сообщений в чате.  | 
 replyMessages |   Необязательно. Настройка ответа на сообщения в чат-группе.  | 
Настройка разрешений
Представляет собой настройку разрешения на использование пространства.
| JSON-представление | 
|---|
{ "managersAllowed": boolean, "membersAllowed": boolean, "assistantManagersAllowed": boolean }  | 
| Поля | |
|---|---|
 managersAllowed |    Необязательно. Есть ли у владельцев пространства (   | 
 membersAllowed |    Необязательно. Имеют ли базовые участники пространства (   | 
 assistantManagersAllowed |    Необязательно. Имеют ли менеджеры пространства   | 
Методы | |
|---|---|
  | Завершает процесс импорта указанного пространства и делает его видимым для пользователей. | 
  | Создает пространство. | 
  | Удаляет именованное пространство. | 
  | Возвращает существующее прямое сообщение с указанным пользователем. | 
  |  Возвращает все пространства с spaceType == GROUP_CHAT , в состав которых входит именно вызывающий пользователь, а также пользователи, указанные в FindGroupChatsRequest.memberships . | 
  | Возвращает подробную информацию о пространстве. | 
  | Выводит список пространств, членом которых является звонящий. | 
  | Обновляет пространство. | 
  | Возвращает список пространств в организации Google Workspace на основе поиска администратора. | 
  | Создает пространство и добавляет в него указанных пользователей. |