REST Resource: spaces

string

Идентификатор. Название ресурса пространства.

Format: spaces/{space}

Где {space} представляет собой системный идентификатор пространства. Вы можете получить идентификатор пространства, вызвав метод spaces.list() или из URL-адреса пространства. Например, если URL-адрес пространства — https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA , то идентификатор пространства — AAAAAAAAA .

enum ( Type )

Только для вывода. Устарело: используйте spaceType вместо этого. Тип пробела.

enum ( SpaceType )

Необязательный параметр. Тип пространства. Обязателен при создании пространства или изменении типа пространства. Выводится только для других целей.

boolean

Необязательно. Укажите, является ли это личным сообщением между приложением для чата и живым человеком.

boolean

Только вывод. Устарело: используйте spaceThreadingState вместо этого. Определяет, объединены ли сообщения в потоки в этом пространстве.

string

Необязательно. Отображаемое имя пространства. Обязательно при создании пространства с spaceType SPACE . Если при создании пространства или обновлении displayName вы получаете сообщение об ошибке ALREADY_EXISTS , попробуйте другое displayName . Возможно, в существующем пространстве в организации Google Workspace уже используется это отображаемое имя.

В личных сообщениях это поле может быть пустым.

Поддерживает до 128 символов.

boolean

Необязательно. Неизменяемо. Разрешает ли данное пространство участвовать любому пользователю Google Chat. Поле вводится при создании пространства в организации Google Workspace. Опустите это поле при создании пространств в следующих условиях:

• Аутентифицированный пользователь использует учетную запись потребителя (неуправляемую учетную запись пользователя). По умолчанию пространство, созданное учетной записью потребителя, разрешает доступ любому пользователю Google Chat.

Для существующих помещений это поле предназначено только для вывода.

enum ( SpaceThreadingState )

Только вывод. Состояние ветки обсуждения в чате.

object ( SpaceDetails )

Необязательно. Подробная информация о помещении, включая описание и правила.

enum ( HistoryState )

Необязательно. История сообщений и веток обсуждений в этом пространстве.

boolean

Необязательно. Указывает, будет ли это пространство создано в Import Mode в рамках миграции данных в Google Workspace. Во время импорта пространства не будут видны пользователям до завершения импорта.

Для создания пространства в Import Mode требуется аутентификация пользователя .

string ( Timestamp format)

Необязательно. Неизменяемо. Для пространств, созданных в чате, указывается время создания пространства. Это поле предназначено только для вывода, за исключением случаев использования в пространствах режима импорта.

Для пространств в режиме импорта установите в этом поле историческую метку времени, в которую пространство было создано в источнике, чтобы сохранить исходное время создания.

Отображается в выходных данных только в том случае, если spaceType имеет значение GROUP_CHAT или SPACE .

string ( Timestamp format)

Только вывод. Временная метка последнего сообщения в этом пространстве.

boolean

Только вывод. Для пространств прямых сообщений (DM) с приложением чата, независимо от того, было ли пространство создано администратором Google Workspace. Администраторы могут устанавливать и настраивать прямые сообщения с приложением чата от имени пользователей в своей организации.

Для поддержки установки администратором ваше приложение чата должно поддерживать прямую переписку.

object ( MembershipCount )

Только для вывода. Количество вступивших в членство, сгруппированное по типу участника. Заполняется, если spaceType имеет значение SPACE , DIRECT_MESSAGE или GROUP_CHAT .

object ( AccessSettings )

Необязательный параметр. Задает параметры доступа к пространству. Заполняется только в том случае, если spaceType имеет значение SPACE .

string

Только для вывода. URI для доступа пользователя к пространству.

string ( Timestamp format)

Только для вывода. Время, когда пространство будет автоматически удалено системой, если она останется в режиме импорта.

Каждое пространство, созданное в режиме импорта, должно выйти из этого режима до истечения указанного времени с помощью spaces.completeImport .

Это поле заполняется только для пространств, созданных в режиме импорта.

string

Необязательный параметр. Неизменяемый. Идентификатор клиента домена пространства. Требуется только при создании пространства с аутентификацией приложения , если SpaceType имеет значение SPACE ; в противном случае параметр задавать не следует.

In the format customers/{customer} , where customer is the id from the Admin SDK customer resource . Private apps can also use the customers/my_customer alias to create the space in the same Google Workspace organization as the app.

Это поле не заполняется для личных сообщений (DM) или при создании пространства пользователями, не являющимися пользователями Google Workspace.

enum ( PredefinedPermissionSettings )

Optional. Input only. Predefined space permission settings, input only when creating a space. If the field is not set, a collaboration space is created. After you create the space, settings are populated in the PermissionSettings field.

Setting predefined permission settings supports:

• Аутентификация приложения с подтверждением администратора с использованием областей действия chat.app.spaces или chat.app.spaces.create .

• Аутентификация пользователя

object ( PermissionSettings )

Optional. Space permission settings for existing spaces. Input for updating exact space permission settings, where existing permission settings are replaced. Output lists current permission settings.

Чтение и обновление настроек прав доступа поддерживают:

• Аутентификация приложения с подтверждением администратора в рамках области действия chat.app.spaces . Заполняется и устанавливается только при создании пространства приложением чата.

• Аутентификация пользователя