Method: spaces.patch

Обновляет пространство. Пример см. в разделе Обновление пространства .

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

Требует аутентификации пользователя .

HTTP-запрос

PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
space.name

string

Имя ресурса пространства.

Формат: spaces/{space}

Параметры запроса

Параметры
updateMask

string ( FieldMask format)

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

Вы можете обновить следующие поля для пространства:

  • spaceDetails

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

  • spaceType : поддерживает только изменение типа пространства GROUP_CHAT на SPACE . Включите displayName вместе с spaceType в маску обновления и убедитесь, что указанное пространство имеет непустое отображаемое имя и тип пространства SPACE . Включение маски spaceType и типа SPACE в указанное пространство при обновлении отображаемого имени не является обязательным, если существующее пространство уже имеет тип SPACE . Попытка обновить тип пространства другими способами приводит к ошибке недопустимого аргумента. spaceType не поддерживается при доступе администратора.

  • spaceHistoryState : обновляет настройки истории пространства , включая или отключая историю для пространства. Поддерживается только в том случае, если для организации Google Workspace включены настройки истории. Чтобы обновить состояние истории пространства, вы должны опустить все остальные маски полей в своем запросе. spaceHistoryState не поддерживается при доступе администратора.

  • accessSettings.audience : обновляет настройки доступа для тех, кто может обнаруживать пространство, присоединяться к нему и просматривать сообщения в именованном пространстве, где поле spaceType равно SPACE . Если у существующего пространства есть целевая аудитория, вы можете удалить аудиторию и ограничить доступ к пространству, опустив значение для этой маски поля. Чтобы обновить настройки доступа для пространства, аутентифицирующий пользователь должен быть менеджером пространства и опустить все остальные маски полей в вашем запросе. Вы не можете обновить это поле, если пространство находится в режиме импорта . Дополнительные сведения см. в разделе Как сделать пространство доступным для просмотра определенным пользователям . accessSettings.audience не поддерживается при доступе администратора.

  • Предварительная версия для разработчиков. Поддерживается изменение настроек разрешений пространства. Поддерживаемые пути к полям включают: permissionSettings.manage_members_and_groups , permissionSettings.modify_space_details , permissionSettings.toggle_history , permissionSettings.use_at_mention_all , permissionSettings.manage_apps , permissionSettings.manage_webhooks , permissionSettings.reply_messages (Предупреждение: взаимное). исключительно с все остальные пути к полям настроек без разрешений). permissionSettings не поддерживается при доступе администратора.

useAdminAccess

boolean

Если true , метод запускается с использованием прав администратора Google Workspace пользователя.

Вызывающий пользователь должен быть администратором Google Workspace с правом управления чатом и беседами в чат-группах .

Требуется область действия OAuth 2.0 chat.admin.spaces .

Некоторые значения FieldMask не поддерживаются при доступе администратора. Подробности смотрите в описании updateMask .

Тело запроса

Тело запроса содержит экземпляр Space .

Тело ответа

В случае успеха тело ответа содержит экземпляр Space .

Области авторизации

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

Дополнительную информацию см. в руководстве по авторизации .