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)

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

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

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

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

  • spaceDetails

  • spaceHistoryState (поддерживает включение и отключение истории для пространства , если организация разрешает пользователям изменять настройки истории . Внимание: взаимоисключающее со всеми другими путями полей.)

  • Предварительная версия для разработчиков: accessSettings.audience (поддерживает изменение настроек доступа к пространству. Если в настройках доступа не указана аудитория, настройка доступа к пространству обновляется до ограниченного. Внимание: взаимоисключающее со всеми другими путями полей.)

Тело запроса

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

Тело ответа

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

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

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

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

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