En esta página, se explica cómo usar la API de Google Chat para compartir un espacio de Google Chat con usuarios específicos de una organización de Google Workspace, de modo que puedan descubrir el espacio y unirse a él.
Para especificar los usuarios de tu organización que pueden descubrir un espacio y unirse a él, crea usuarios objetivo. Un público objetivo es un grupo de personas, como departamentos específicos o toda la organización, con los que puedes compartir un espacio de Chat para mejorar el reconocimiento y la capacidad de compartir del espacio. Los usuarios objetivo también te permiten administrar y personalizar las membresías del espacio, en lugar de tener que invitar a usuarios individuales a un espacio. Para obtener más información, consulta Acerca de los públicos objetivo.
Solo puedes hacer que los espacios con nombre sean visibles para el público objetivo. No puedes compartir otros tipos de espacios, como mensajes directos o conversaciones grupales, con los usuarios objetivo.
Requisitos previos
- Una cuenta de Google Workspace con acceso a Google Chat Tu cuenta debe tener la función de administrador avanzado para la organización de Google Workspace.
- Un público objetivo al que se puede acceder en Chat Para crear un público objetivo, consulta Crea un público objetivo. Si quieres que un público objetivo existente esté disponible para los espacios de Chat, consulta Configura el acceso al espacio para Chat.
Obtén el ID del público objetivo
Para obtener el ID de un público objetivo, haz lo siguiente:
En la Consola del administrador de Google, ve al menú > Directorio > Públicos objetivo.
En la tabla Usuarios objetivo, haz clic en el campo Nombre del público objetivo.
Busca el ID de público objetivo en la URL de la página. El formato de URL es
https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID
, en el queTARGET_AUDIENCE_ID
es el ID alfanumérico de tu público objetivo.
En la siguiente sección, usarás el ID de público objetivo con el fin de crear un espacio detectable o actualizar un espacio existente para que sea detectable para el público objetivo.
Especifica el público objetivo en tu solicitud a la API de Chat
Si quieres crear un espacio para un público objetivo específico, usa el método create()
o setup()
en el recurso Space
. Para que un espacio existente sea detectable, usa el método update()
en el recurso Space
. Debido a que solo los espacios con nombre se pueden compartir con los usuarios objetivo, el tipo de espacio (representado en el campo spaceType
) debe ser SPACE
.
Para que tu público objetivo pueda encontrar un espacio, incluye el objeto
AccessSettings
en el recurso Space
como parte de tu solicitud a la API de Chat. En el objeto, especifica el campo audience
:
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
Reemplaza TARGET_AUDIENCE_ID
por el ID del público objetivo que obtuviste en la sección anterior. Si quieres usar la configuración predeterminada de uso compartido del espacio de Chat para tu organización de Google Workspace, reemplázala por default
.
Si quieres obtener detalles para crear o actualizar espacios con la API de Chat, consulta las siguientes guías:
Temas relacionados
- Cómo crear un público objetivo
- Configura el uso compartido en Chat
- Crea espacios con diferentes niveles de acceso