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}

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

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

Параметры
updateMask

string ( FieldMask format)

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

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

spaceDetails : обновляет описание пространства. Поддерживает до 150 символов.

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

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

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

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

permissionSettings : поддерживает изменение настроек разрешений пространства. При обновлении настроек разрешений можно указать только маски полей permissionSettings ; вы не можете одновременно обновлять другие маски полей. permissionSettings не поддерживается с помощью useAdminAccess . Поддерживаемые маски полей включают:

  • permissionSettings.manageMembersAndGroups
  • permissionSettings.modifySpaceDetails
  • permissionSettings.toggleHistory
  • permissionSettings.useAtMentionAll
  • permissionSettings.manageApps
  • permissionSettings.manageWebhooks
  • permissionSettings.replyMessages
useAdminAccess

boolean

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

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

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

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

Тело запроса

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

Тело ответа

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

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

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

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

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