REST Resource: spaces.members

Recurso: Membresía

Representa una relación de membresía en Google Chat, por ejemplo, si un usuario o una app de Chat está invitado a un espacio, forma parte de él o no está presente.

Representación 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. Es el nombre del recurso de la membresía que asignó el servidor.

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

state

enum (MembershipState)

Solo salida. Estado de la membresía.

role

enum (MembershipRole)

Opcional. Es el rol del usuario dentro de un espacio de Chat, que determina las acciones permitidas en el espacio.

Este campo solo se puede usar como entrada en members.patch.

createTime

string (Timestamp format)

Opcional. Inmutable. La hora de creación de la membresía, como el momento en que un miembro se unió a un espacio o se le invitó a hacerlo. Este campo solo se usa para generar resultados, excepto cuando se usa para importar membresías históricas en espacios en modo de importación.

deleteTime

string (Timestamp format)

Opcional. Inmutable. La hora de eliminación de la membresía, por ejemplo, cuándo un miembro abandonó un espacio o se quitó de él Este campo solo se usa para generar resultados, excepto cuando se usa para importar membresías históricas en espacios en modo de importación.

Campo de unión memberType. Miembro asociado con esta membresía. Es posible que se admitan otros tipos de miembros en el futuro. Las direcciones (memberType) solo pueden ser una de las siguientes opciones:
member

object (User)

Opcional. El usuario o la app de Google Chat a la que corresponde la membresía. Si tu app de Chat se autentica como un usuario, el resultado propaga los name y type del usuario.

groupMember

object (Group)

Opcional. El Grupo de Google al que corresponde la membresía.

Para leer o modificar las membresías de Grupos de Google, se requiere la autenticación del usuario.

MembershipState

Especifica la relación del miembro con un espacio. Es posible que se admitan otros estados de membresía en el futuro.

Enumeraciones
MEMBERSHIP_STATE_UNSPECIFIED Valor predeterminado No lo uses.
JOINED El usuario se agrega al espacio y puede participar en él.
INVITED Se invitó al usuario a unirse al espacio, pero aún no lo ha hecho.
NOT_A_MEMBER El usuario no pertenece al espacio y no tiene una invitación pendiente para unirse a él.

MembershipRole

Representa las acciones permitidas de un usuario en un espacio de Chat. Es posible que se agreguen más valores de enumeración en el futuro.

Enumeraciones
MEMBERSHIP_ROLE_UNSPECIFIED Valor predeterminado En el caso de users, no es miembro del espacio, pero se le puede invitar. Para Google Groups: Siempre se les asigna este rol (es posible que se usen otros valores de enumeración en el futuro).
ROLE_MEMBER Un miembro del espacio. El usuario tiene permisos básicos, como enviar mensajes al espacio. En las conversaciones 1:1 y en grupo sin nombre, todos tienen este rol.
ROLE_MANAGER Un administrador del espacio El usuario tiene todos los permisos básicos, además de los permisos administrativos que le permiten administrar el espacio, como agregar o quitar miembros. Solo se admite en SpaceType.SPACE.

Grupo

Un Grupo de Google en Google Chat.

Representación JSON
{
  "name": string
}
Campos
name

string

Es el nombre de recurso de un Grupo de Google.

Representa un grupo en la API de Grupos de Cloud Identity.

Formato: groups/{group}

Métodos

create

Crea una membresía para la app de Chat de llamadas, un usuario o un Grupo de Google.

delete

Borra una membresía.

get

Muestra los detalles de una membresía.

list

Muestra las membresías de un espacio.

patch

Actualiza una membresía.