Method: spaces.patch

Actualiza un espacio. Para ver un ejemplo, consulta Actualiza un espacio.

Si actualizas el campo displayName y recibes el mensaje de error ALREADY_EXISTS, prueba con un nombre visible diferente. Es posible que un espacio existente en la organización de Google Workspace ya use este nombre visible.

Admite los siguientes tipos de autenticación:

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
space.name

string

Identificador. Es el nombre del recurso del espacio.

Formato: spaces/{space}

En el que {space} representa el ID asignado por el sistema para el espacio. Para obtener el ID del espacio, llama al método spaces.list() o desde la URL del espacio. Por ejemplo, si la URL del espacio es https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA, el ID del espacio es AAAAAAAAA.

Parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

Obligatorio. Las rutas de acceso de los campos actualizadas, separadas por comas si hay varias.

Puedes actualizar los siguientes campos de un espacio:

spaceDetails: Actualiza la descripción del espacio. Admite hasta 150 caracteres.

displayName: Solo admite la actualización del nombre visible de los espacios en los que el campo spaceType es SPACE. Si recibes el mensaje de error ALREADY_EXISTS, prueba con otro valor. Es posible que un espacio existente dentro de la organización de Google Workspace ya use este nombre visible.

spaceType: Solo admite cambiar un tipo de espacio GROUP_CHAT a SPACE. Incluye displayName junto con spaceType en la máscara de actualización y asegúrate de que el espacio especificado tenga un nombre visible que no esté vacío y el tipo de espacio SPACE. Incluir la máscara spaceType y el tipo SPACE en el espacio especificado cuando se actualiza el nombre visible es opcional si el espacio existente ya tiene el tipo SPACE. Si intentas actualizar el tipo de espacio de otras maneras, se mostrará un error de argumento no válido. spaceType no es compatible con useAdminAccess.

spaceHistoryState: Actualiza la configuración del historial del espacio activando o desactivando el historial del espacio. Solo se admite si la configuración del historial está habilitada para la organización de Google Workspace. Para actualizar el estado del historial de espacios, debes omitir todas las demás máscaras de campo en la solicitud. spaceHistoryState no es compatible con useAdminAccess.

accessSettings.audience: Actualiza el parámetro de configuración de acceso sobre quién puede descubrir el espacio, unirse a él y obtener una vista previa de los mensajes en un espacio con nombre en el que el campo spaceType es SPACE. Si el espacio existente tiene un público objetivo, puedes quitarlo y restringir el acceso al espacio omitiendo un valor para esta máscara de campo. Para actualizar la configuración de acceso de un espacio, el usuario que realiza la autenticación debe ser administrador del espacio y omitir todas las demás máscaras de campo en la solicitud. No puedes actualizar este campo si el espacio está en modo de importación. Para obtener más información, consulta Haz que un espacio sea visible para usuarios específicos. accessSettings.audience no es compatible con useAdminAccess.

permissionSettings: Admite cambiar la configuración de permisos de un espacio. Cuando actualizas la configuración de permisos, solo puedes especificar máscaras de campo permissionSettings. No puedes actualizar otras máscaras de campo al mismo tiempo. permissionSettings no es compatible con useAdminAccess. Entre las máscaras de campo admitidas, se incluyen las siguientes:

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

boolean

Opcional. Cuando es true, el método se ejecuta con los privilegios de administrador de Google Workspace del usuario.

El usuario que realiza la llamada debe ser administrador de Google Workspace con el privilegio para administrar el chat y las conversaciones de los espacios.

Requiere el permiso de OAuth 2.0 chat.admin.spaces.

Algunos valores de FieldMask no son compatibles con el acceso de administrador. Para obtener más información, consulta la descripción de updateMask.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Space.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Space.

Alcances de autorización

Se necesita uno de los siguientes permisos de 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

Para obtener más información, consulta la Guía de autorización.