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 públicos objetivos. Un público objetivo es un grupo de personas, como departamentos específicos o toda la organización, con el que puedes compartir un espacio de Chat para mejorar el conocimiento y la capacidad de uso compartido del espacio. Los públicos objetivos 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 objetivos.

Solo puedes hacer que los espacios con nombre sean detectables para los públicos objetivos. No puedes compartir otros tipos de espacios, como mensajes directos o conversaciones grupales, con públicos objetivos.

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.

    Ir a Públicos 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 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

Para crear un espacio para un público objetivo específico, usa el create() o setup() método en el Space recurso. Para que un espacio existente sea detectable, usa el update() método en el Space recurso. Debido a que solo los espacios con nombre se pueden compartir con públicos objetivos, 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 AccessSettings objeto en el Space recurso 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, reemplaza por default.

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