Method: spaces.patch

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

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

Поддерживает следующие типы аутентификации :

  • Аутентификация приложения с одобрением администратора и одной из следующих областей авторизации:

    • https://www.googleapis.com/auth/chat.app.spaces
  • Аутентификация пользователя с одной из следующих областей авторизации:

    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.import (только пространство в режиме импорта)
    • Аутентификация пользователя предоставляет привилегии администратора, когда учетная запись администратора проходит аутентификацию, useAdminAccess имеет true и используются следующие области авторизации:
      • https://www.googleapis.com/auth/chat.admin.spaces

Аутентификация приложения имеет следующие ограничения:

  • Чтобы обновить space.predefined_permission_settings или space.permission_settings , приложение должно быть создателем пространства.
  • Обновление space.access_settings.audience не поддерживается для аутентификации приложения.

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

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