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 las que puedes compartir un espacio de Chat para mejorar su visibilidad y capacidad de uso compartido. Los públicos objetivo también te permiten administrar y personalizar las membresías de los espacios 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

Para 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. Dado que solo se pueden compartir espacios nombrados con públicos objetivo, el tipo de espacio (representado en el campo spaceType) debe ser SPACE.

Para que un espacio sea detectable para tu público objetivo, 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. Para usar la configuración predeterminada de uso compartido de espacios de Chat para tu organización de Google Workspace, reemplázalo por default.

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