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 otro nombre visible. Es posible que un espacio existente dentro de la organización de Google Workspace ya use este nombre visible.

Requiere la autenticación del usuario.

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

Es el nombre del recurso del espacio.

Formato: spaces/{space}

Parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

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

Rutas de campo admitidas actualmente:

  • displayName (solo permite cambiar el nombre visible de un espacio con el tipo SPACE o si también se incluye la máscara spaceType para cambiar un tipo de espacio GROUP_CHAT a SPACE). Si intentas actualizar el nombre visible de un espacio GROUP_CHAT o DIRECT_MESSAGE, se generará un error de argumento no válido. Si recibes el mensaje de error ALREADY_EXISTS cuando actualizas displayName, prueba con otra displayName. Es posible que un espacio existente dentro de la organización de Google Workspace ya use este nombre visible).

  • spaceType (solo permite cambiar el 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 y el tipo de espacio SPACE que no esté vacío. 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 otra manera, se producirá un error de argumento no válido).

  • spaceDetails

  • spaceHistoryState (permite activar o desactivar el historial del espacio si la organización permite que los usuarios cambien el parámetro de configuración del historial. Advertencia: Es mutuamente excluyente con todas las demás rutas de campo).

  • Vista previa para desarrolladores: accessSettings.audience (permite cambiar la configuración de acceso de un espacio. Si no se especifica un público en el parámetro de configuración de acceso, el acceso del espacio se actualiza a restringido. Advertencia: Es mutuamente excluyente con todas las demás rutas de campo).

Cuerpo de la solicitud

El cuerpo de la solicitud incluye una instancia de Space.

Cuerpo de la respuesta

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

Permisos de autorización

Se necesita uno de los siguientes alcances de OAuth:

  • 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.