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 para que eles possam descobrir e participar do espaço.

Para especificar os usuários na sua organização que podem descobrir e participar de um espaço, crie públicos-alvo. Um público-alvo é um grupo de pessoas, como departamentos específicos ou toda a organização, com quem você pode compartilhar um espaço do Chat para melhorar o reconhecimento e o compartilhamento. Os públicos-alvo também permitem gerenciar e personalizar as assinaturas de espaço, em vez de convidar usuários individuais para um espaço. Para mais informações, consulte Sobre os públicos-alvo de segmentação.

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

Pré-requisitos

Receber o ID do público-alvo

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

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

    Acesse "Públicos-alvo"

  2. Na tabela Públicos-alvo, clique no campo Nome do 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 seu público-alvo.

Na próxima seção, você vai usar o ID do público-alvo para criar ou atualizar um espaço detectável para que ele seja visível ao 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 o método create() ou setup() no recurso Space. Para tornar um espaço detectável, use o método update() no recurso Space. Como apenas espaços nomeados podem ser compartilhados com públicos-alvo, o tipo de espaço (representado no campo spaceType) precisa ser SPACE.

Para deixar um espaço visível ao público-alvo, inclua o objeto AccessSettings no recurso Space como parte da solicitação da API Chat. No objeto, especifique o campo audience:

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

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

Para detalhes sobre como criar ou atualizar espaços usando a API Chat, consulte estes guias: