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 en la organización de Google Workspace ya use este nombre visible.

Se 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

Nombre de recurso del espacio.

Formato: spaces/{space}

Parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

Obligatorio. Las rutas de campo actualizadas, separadas por comas si son varias.

Rutas de campo admitidas actualmente:

  • displayName (Solo admite el cambio del nombre visible de un espacio con el tipo SPACE o cuando 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 de GROUP_CHAT o DIRECT_MESSAGE, se mostrará un error de argumento no válido. Si recibes el mensaje de error ALREADY_EXISTS cuando actualizas displayName, prueba con otro displayName. Es posible que un espacio existente en la organización de Google Workspace ya use este nombre visible).

  • spaceType (Solo admite el cambio de 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 formas, se mostrará un error de argumento no válido. spaceType no es compatible con el acceso de administrador.

  • spaceDetails

  • spaceHistoryState (Admite activar o desactivar el historial del espacio si la organización permite que los usuarios cambien el parámetro de configuración de su historial. Advertencia: mutuamente excluyentes con todas las demás rutas de campo). spaceHistoryState no es compatible con el acceso de administrador.

  • Versión preliminar para desarrolladores: accessSettings.audience (admite el cambio de la configuración de acceso de un espacio. Si no se especifica ningún público en el parámetro de configuración de acceso, el parámetro de acceso del espacio se actualizará a restringido. Advertencia: mutuamente excluyentes con todas las demás rutas de campo). accessSettings.audience no es compatible con el acceso de administrador.

  • Versión preliminar para desarrolladores: Admite el cambio de la configuración de permisos de un espacio. Las rutas de campo admitidas incluyen lo siguiente: permissionSettings.manage_members_and_groups, permissionSettings.modify_space_details, permissionSettings.toggle_history, permissionSettings.use_at_mention_all, permissionSettings.manage_apps, permissionSettings.manage_webhooks y permissionSettings.reply_messages (Advertencia: mutuamente excluyentes con todas las demás rutas de campo de configuración sin permisos). permissionSettings no es compatible con el acceso de administrador.

useAdminAccess

boolean

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