Hacer que un espacio de Google Chat sea visible para usuarios específicos de una organización de Google Workspace

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 descubrirlo y unirse a él.

Para especificar los usuarios de tu organización que pueden descubrir un espacio y unirse a él, debes crear públicos 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 detectables para los públicos objetivo. No puedes compartir otros tipos de espacios, como mensajes directos o conversaciones grupales, con públicos objetivo.

Requisitos previos

Obtén el ID del público objetivo

Para obtener el ID de un público objetivo, haz lo siguiente:

  1. En la Consola del administrador de Google, ve a Menú > Directorio> Públicos objetivo.

    Ve a Usuarios objetivo.

  2. En la tabla Públicos objetivo, haz clic en el campo Nombre del público objetivo.

  3. Busca el ID del público objetivo en la URL de la página. El formato de la URL es https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID, en el que TARGET_AUDIENCE_ID es el ID alfanumérico de tu público objetivo.

En la siguiente sección, usarás el ID del público objetivo para crear un espacio detectable o actualizar uno existente para que el público objetivo pueda encontrarlo.

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. Como solo se pueden compartir espacios nombrados con públicos 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.

Para obtener detalles sobre cómo crear o actualizar espacios con la API de Chat, consulta las siguientes guías: