REST Resource: spaces.members

Recurso: Membership

Representa uma relação de associação no Google Chat, como se um usuário ou app do Chat foi convidado para um espaço, faz parte dele ou não está presente.

Representação JSON 
{
  "name": string,
  "state": enum (MembershipState),
  "role": enum (MembershipRole),
  "createTime": string,
  "deleteTime": string,

  // Union field memberType can be only one of the following:
  "member": {
    object (User)
  },
  "groupMember": {
    object (Group)
  }
  // End of list of possible types for union field memberType.
}
Campos
name

string

Identificador. Nome do recurso da assinatura, atribuído pelo servidor.

Formato: spaces/{space}/members/{member}
state

enum (MembershipState)

Apenas saída. Estado da assinatura.
role

enum (MembershipRole)

Opcional. Função do usuário em um espaço do Chat, que determina as ações permitidas nele.

Este campo só pode ser usado como entrada em members.patch.
createTime

string (Timestamp format)

Opcional. Imutável. O momento da criação da associação, como quando um participante entrou ou foi convidado para entrar em um espaço. Esse campo é somente de saída, exceto quando usado para importar associações históricas em espaços do modo de importação.
deleteTime

string (Timestamp format)

Opcional. Imutável. O horário de exclusão da assinatura, como quando um participante saiu ou foi removido de um espaço. Esse campo é somente de saída, exceto quando usado para importar associações históricas em espaços do modo de importação.
Campo de união memberType. Membro associado a esta assinatura. Outros tipos de membros poderão ser aceitos no futuro. memberType pode ser apenas de um dos tipos a seguir:
member

object (User)

Opcional. O usuário ou app do Google Chat a que a assinatura corresponde. Se o app do Chat autenticar como um usuário, a saída vai preencher os name e type do usuário.
groupMember

object (Group)

Opcional. O grupo do Google a que a associação corresponde.

Para ler ou alterar associações aos Grupos do Google, é necessário fazer a autenticação do usuário.

MembershipState

Especifica a relação do membro com um espaço. Outros estados de assinatura poderão ser compatíveis no futuro.

Tipos enumerados
MEMBERSHIP_STATE_UNSPECIFIED Valor padrão. Não use.
JOINED O usuário é adicionado ao espaço e pode participar dele.
INVITED O usuário foi convidado para participar do espaço, mas ainda não entrou.
NOT_A_MEMBER O usuário não pertence ao espaço e não tem um convite pendente para participar dele.

MembershipRole

Representa as ações permitidas de um usuário em um espaço do Chat. Mais valores de enumeração podem ser adicionados no futuro.

Tipos enumerados
MEMBERSHIP_ROLE_UNSPECIFIED Valor padrão. Para users: essa pessoa não é participante do espaço, mas pode ser convidada. Para Google Groups: eles sempre recebem essa função (outros valores de enumeração podem ser usados no futuro).
ROLE_MEMBER

Um participante do espaço. Na interface do Chat, essa função é chamada de "Membro".

O usuário tem permissões básicas, como enviar mensagens para o espaço. Os gerentes e proprietários podem conceder aos participantes permissões extras em um espaço, incluindo:

  • Adicione ou remova membros.
  • Modificar detalhes do espaço.
  • Ative ou desative o histórico.
  • Mencione todos no espaço com @all.
  • Gerenciar apps do Chat e webhooks instalados no espaço.

Nas mensagens diretas e conversas em grupo sem nome, todos têm essa função.
ROLE_MANAGER

Um proprietário do espaço. Na interface de chat, essa função é chamada de "Proprietário".

O usuário tem o conjunto completo de permissões do espaço para gerenciar o espaço, incluindo:

  • Mude a função de outros participantes no espaço para participante, administrador ou proprietário.
  • Exclua o espaço.

Compatível apenas com SpaceType.SPACE (espaços nomeados).

Para saber mais, consulte Saiba mais sobre sua função como proprietário ou administrador do espaço.
ROLE_ASSISTANT_MANAGER

Um administrador do espaço. Na interface do Chat, essa função é chamada de "Gerente".

O usuário tem todas as permissões básicas de ROLE_MEMBER e pode receber um subconjunto de permissões administrativas de um proprietário. Por padrão, os administradores têm todas as permissões de um proprietário, exceto a capacidade de:

  • Exclua o espaço.
  • Transformar outro participante em proprietário.
  • Mudar a função de um proprietário.

Por padrão, as permissões dos administradores incluem, entre outras:

  • Transformar outro participante em administrador
  • Excluir mensagens no espaço.
  • Gerenciar permissões do espaço.
  • Receber notificações de solicitações para participar do espaço se o administrador tiver a permissão "gerenciar participantes" nas configurações do espaço.
  • Tornar um espaço detectável.

Compatível apenas com SpaceType.SPACE (espaços nomeados).

Para saber mais, consulte Gerenciar configurações do espaço.

Grupo

Um grupo do Google no Google Chat.

Representação JSON 
{
  "name": string
}
Campos
name

string

Nome do recurso de um Grupo do Google.

Representa um grupo na API Cloud Identity Groups.

Formato: groups/{group}

Métodos

create

 Cria uma associação para o app de chat que faz a chamada, um usuário ou um grupo do Google.

delete

 Exclui uma assinatura.

get

 Retorna detalhes sobre uma assinatura.

list

 Lista as assinaturas em um espaço.

patch

 Atualiza uma assinatura.