Tornar um espaço do Google Chat detectável para usuários específicos em uma organização do Google Workspace

Esta página explica como usar a API Google Chat para compartilhar um espaço do Google Chat com usuários específicos em uma organização do Google Workspace, descobrir e participar do espaço.

Para especificar os usuários na sua organização que podem encontrar e participar de um espaço, faça o seguinte: a criar públicos-alvo. Um público-alvo é um grupo de pessoas, como departamentos específicos ou de toda a organização, com as quais você pode Espaço do Chat com o objetivo de aumentar a conscientização e o compartilhamento. Com os públicos-alvo, você também pode gerenciar e personalizar o espaço assinaturas, em vez de convidar usuários específicos para um espaço. Para mais informações, consulte Sobre a segmentação .

Só é possível tornar os espaços nomeados detectáveis para públicos-alvo. Você não pode compartilhar outros tipos de espaços, como mensagens diretas ou conversas em grupo, com públicos-alvo.

Pré-requisitos

Encontrar o ID do público-alvo

Para encontrar o ID de um público-alvo, faça o seguinte:

  1. No Google Admin Console, acesse Cardápio > Diretório > Públicos-alvo.

    Acessar "Públicos-alvo"

  2. Na tabela Públicos-alvo, clique no campo Nome da segmentação. público-alvo.

  3. Encontre o ID do público-alvo no URL da página. O formato do URL é https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID, em que TARGET_AUDIENCE_ID é o ID alfanumérico do ao seu público-alvo.

Na próxima seção, você vai usar o ID do público-alvo para criar espaço detectável ou atualizar um existente para torná-lo detectável para o público-alvo.

Especificar o público-alvo na solicitação da API Chat

Para criar um espaço para um público-alvo específico, use create() ou Método setup() no recurso Space. Para criar um espaço existente detectáveis, use o método update() no recurso Space. Porque somente os espaços nomeados podem ser compartilhados com públicos-alvo, o tipo de espaço (representado no campo spaceType) precisa ser SPACE.

Para tornar um espaço detectável para seu público-alvo, inclua o AccessSettings no recurso Space como parte da solicitação da API Chat. Em o objeto, especifique o campo audience:

  "accessSettings": {
    "audience": "audiences/TARGET_AUDIENCE_ID"
  }

Substitua TARGET_AUDIENCE_ID pelo ID do destino. público-alvo que você obteve na seção anterior. Para usar o padrão Configurações de compartilhamento do espaço do Chat no seu Google Workspace organização, substitua por default.

Saiba como criar ou atualizar espaços usando a API Chat em seguintes guias: