Um espaço no Google Chat. Os espaços são conversas entre dois ou mais usuários ou mensagens individuais entre um usuário e um app do Chat.
Representação JSON
{ "name": string, "type": enum (Type), "spaceType": enum (SpaceType), "singleUserBotDm": boolean, "threaded": boolean, "displayName": string, "externalUserAllowed": boolean, "spaceThreadingState": enum (SpaceThreadingState), "spaceDetails": { object (SpaceDetails) }, "spaceHistoryState": enum (HistoryState), "importMode": boolean, "createTime": string, "lastActiveTime": string, "adminInstalled": boolean, "membershipCount": { object (MembershipCount) }, "accessSettings": { object (AccessSettings) }, "spaceUri": string, "importModeExpireTime": string, "customer": string, // Union field space_permission_settings can be only one of the following: "predefinedPermissionSettings": enum (PredefinedPermissionSettings), "permissionSettings": { object (PermissionSettings) } // End of list of possible types for union field space_permission_settings. }
Campos
name
string Identificador. Nome do recurso do espaço.Formato: spaces/{space}Em que {space} representa o ID atribuído pelo sistema ao espaço. Para conseguir o ID do espaço, chame o método spaces.list() ou acesse o URL do espaço. Por exemplo, se o URL do espaço for https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA, o ID do espaço será AAAAAAAAA.
type**(deprecated)**
enum (Type) Apenas saída. Descontinuado: use spaceType. O tipo de um espaço.
spaceType
enum (SpaceType) Opcional. O tipo de espaço. Obrigatório ao criar ou atualizar o tipo de um espaço. Apenas saída para outros usos.
singleUserBotDm
boolean Opcional. Se o espaço é uma mensagem direta entre um app de chat e uma única pessoa.
threaded**(deprecated)**
boolean Apenas saída. Descontinuado: use spaceThreadingState. Se as mensagens são agrupadas neste espaço.
displayName
string Opcional. O nome de exibição do espaço. Obrigatório ao criar um espaço com um spaceType de SPACE. Se você receber a mensagem de erro ALREADY_EXISTS ao criar um espaço ou atualizar o displayName, tente usar outro displayName. Um espaço na organização do Google Workspace já pode usar esse nome de exibição.Para mensagens diretas, esse campo pode estar vazio.Aceita até 128 caracteres.
externalUserAllowed
boolean Opcional. Imutável. Indica se o espaço permite que qualquer usuário do Google Chat seja um participante. Entrada ao criar um espaço em uma organização do Google Workspace. Omita esse campo ao criar espaços nas seguintes condições: O usuário autenticado usa uma conta pessoal (conta de usuário não gerenciada). Por padrão, um espaço criado por uma conta pessoal permite qualquer usuário do Google Chat. Para espaços atuais, esse campo é somente saída.
spaceThreadingState
enum (SpaceThreadingState) Apenas saída. O estado de agrupamento no espaço do Chat.
spaceDetails
object (SpaceDetails) Opcional. Detalhes sobre o espaço, incluindo descrição e regras.
spaceHistoryState
enum (HistoryState) Opcional. O estado do histórico de mensagens e conversas neste espaço.
importMode
boolean Opcional. Se este espaço foi criado em Import Mode como parte de uma migração de dados para o Google Workspace. Enquanto os espaços estão sendo importados, eles não ficam visíveis para os usuários até a conclusão da importação.Para criar um espaço no Import Mode, é necessário fazer a autenticação do usuário.
createTime
string (Timestamp format) Opcional. Imutável. Para espaços criados no Chat, a data e a hora em que o espaço foi criado. Esse campo é somente saída, exceto quando usado em espaços no modo de importação.Para espaços no modo de importação, defina esse campo como o carimbo de data/hora histórico em que o espaço foi criado na origem para preservar o horário de criação original.Só é preenchido na saída quando spaceType é GROUP_CHAT ou SPACE.
lastActiveTime
string (Timestamp format) Apenas saída. Carimbo de data/hora da última mensagem no espaço.
adminInstalled
boolean Apenas saída. Para espaços de mensagem direta (MD) com um app do Chat, se o espaço foi criado por um administrador do Google Workspace. Os administradores podem instalar e configurar uma mensagem direta com um app do Chat em nome dos usuários da organização.Para oferecer suporte à instalação pelo administrador, seu app do Chat precisa ter mensagens diretas.
membershipCount
object (MembershipCount) Apenas saída. A contagem de assinaturas agrupadas por tipo de membro. Preenchido quando o spaceType é SPACE, DIRECT_MESSAGE ou GROUP_CHAT.
string Apenas saída. O URI para um usuário acessar o espaço.
importModeExpireTime
string (Timestamp format) Apenas saída. O momento em que o espaço será excluído automaticamente pelo sistema se permanecer no modo de importação.Cada espaço criado no modo de importação precisa sair desse modo antes do tempo de expiração usando spaces.completeImport.Esse campo só é preenchido para espaços criados com o modo de importação.
customer
string Opcional. Imutável. O ID do cliente do domínio do espaço. Obrigatório apenas ao criar um espaço com autenticação de app e SpaceType for SPACE. Caso contrário, não deve ser definido.No formato customers/{customer}, em que customer é o id do recurso de cliente do SDK Admin. Os apps particulares também podem usar o alias customers/my_customer para criar o espaço na mesma organização do Google Workspace que o app.Esse campo não é preenchido para mensagens diretas ou quando o espaço é criado por usuários que não são do Google Workspace.
Campo de união space_permission_settings. Representa as configurações de permissão de um espaço. Preenchido apenas quando space_type é SPACE. space_permission_settings pode ser apenas um dos seguintes:
predefinedPermissionSettings
enum (PredefinedPermissionSettings) Opcional. Somente entrada. Configurações de permissão de espaço predefinidas, inseridas apenas ao criar um espaço. Se o campo não for definido, um espaço de colaboração será criado. Depois de criar o espaço, as configurações são preenchidas no campo PermissionSettings.A definição de configurações de permissão predefinidas é compatível com: Autenticação de app com aprovação do administrador com os escopos chat.app.spaces ou chat.app.spaces.create. Autenticação de usuários
permissionSettings
object (PermissionSettings) Opcional. Configurações de permissão do espaço para espaços atuais. Entrada para atualizar as configurações exatas de permissão de espaço, em que as configurações de permissão atuais são substituídas. A saída lista as configurações de permissão atuais.A leitura e a atualização das configurações de permissão são compatíveis com: Autenticação de app com aprovação do administrador com o escopo chat.app.spaces. Preenchido e definível apenas quando o app Chat criou o espaço. Autenticação de usuários
Tipo
Descontinuado: use SpaceType.
Tipos enumerados
TYPE_UNSPECIFIED
Reservado.
ROOM
Conversas entre duas ou mais pessoas.
DM
Mensagem direta individual entre um humano e um app de chat, em que todas as mensagens são simples. Isso não inclui mensagens diretas entre duas pessoas.
SpaceType
O tipo de espaço. Obrigatório ao criar ou atualizar um espaço. Apenas saída para outros usos.
Tipos enumerados
SPACE_TYPE_UNSPECIFIED
Reservado.
SPACE
Um lugar onde as pessoas enviam mensagens, compartilham arquivos e colaboram. Um SPACE pode incluir apps do Chat.
GROUP_CHAT
Conversas em grupo entre três ou mais pessoas. Um GROUP_CHAT pode incluir apps do Chat.
DIRECT_MESSAGE
Mensagens individuais entre duas pessoas ou entre uma pessoa e um app de chat.
SpaceThreadingState
Especifica o tipo de estado de encadeamento no espaço do Chat.
Tipos enumerados
SPACE_THREADING_STATE_UNSPECIFIED
Reservado.
THREADED_MESSAGES
Espaços nomeados que oferecem suporte a conversas por mensagens. Quando os usuários respondem a uma mensagem, eles podem fazer isso na conversa, o que mantém a resposta no contexto da mensagem original.
GROUPED_MESSAGES
Espaços nomeados em que a conversa é organizada por tema. Os tópicos e as respostas são agrupados.
UNTHREADED_MESSAGES
Mensagens diretas (DMs) entre duas pessoas e conversas em grupo entre três ou mais pessoas.
SpaceDetails
Detalhes sobre o espaço, incluindo descrição e regras.
Representação JSON
{ "description": string, "guidelines": string }
Campos
description
string Opcional. Uma descrição do espaço. Por exemplo, descreva o tema de discussão, a finalidade funcional ou os participantes do espaço.Aceita até 150 caracteres.
guidelines
string Opcional. As regras, expectativas e etiqueta do espaço.Aceita até 5.000 caracteres.
HistoryState
O estado do histórico de mensagens e espaços. Especifica por quanto tempo as mensagens e as conversas são mantidas após a criação.
integer Apenas saída. Contagem de usuários humanos que entraram diretamente no espaço, sem contar os usuários que entraram por serem membros de um grupo.
joinedGroupCount
integer Apenas saída. Contagem de todos os grupos que entraram diretamente no espaço.
enum (AccessState) Apenas saída. Indica o estado de acesso do espaço.
audience
string Opcional. O nome do recurso do público-alvo que pode descobrir, participar e visualizar as mensagens do espaço. Se não estiver definida, somente os usuários ou Grupos do Google que foram convidados ou adicionados individualmente ao espaço poderão acessá-lo. Para mais detalhes, consulte Tornar um espaço detectável para um público-alvo.Formato: audiences/{audience}Para usar o público-alvo padrão da organização do Google Workspace, defina como audiences/default.A leitura do público-alvo é compatível com: Autenticação de usuáriosAutenticação de app com aprovação do administrador com o escopo chat.app.spaces. Esse campo não é preenchido ao usar o escopo chat.bot com a autenticação do app.Para definir o público-alvo, é necessário fazer a autenticação do usuário.
AccessState
Representa o estado de acesso do espaço.
Tipos enumerados
ACCESS_STATE_UNSPECIFIED
O estado de acesso é desconhecido ou não é compatível com esta API.
PRIVATE
Somente usuários ou Grupos do Google que foram adicionados ou convidados individualmente por outros usuários ou administradores do Google Workspace podem descobrir e acessar o espaço.
DISCOVERABLE
Um administrador do espaço concedeu acesso a um público-alvo. Os usuários ou Grupos do Google que foram adicionados ou convidados individualmente para o espaço também podem descobrir e acessar o espaço. Saiba mais em Tornar um espaço detectável para usuários específicos.Para criar espaços visíveis, é necessário fazer a autenticação do usuário.
PredefinedPermissionSettings
Configurações de permissão predefinidas que só podem ser especificadas ao criar um espaço nomeado. Mais configurações poderão ser adicionadas no futuro. Para detalhes sobre as configurações de permissão para espaços nomeados, consulte Saiba mais sobre os espaços.
Tipos enumerados
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED
Não especificado. Não use.
COLLABORATION_SPACE
Configuração para transformar o espaço em um ambiente de colaboração em que todos os participantes podem postar mensagens.
ANNOUNCEMENT_SPACE
Configuração para transformar o espaço em um espaço de aviso em que apenas os administradores podem postar mensagens.
Retorna todos os espaços com spaceType == GROUP_CHAT, cujas associações humanas contêm exatamente o usuário que fez a chamada e os usuários especificados em FindGroupChatsRequest.memberships.