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

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 al menú > Directorio > Públicos objetivo.

    Ir a Públicos objetivo

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

  3. 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 que TARGET_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: