Method: spaces.members.list

Muestra una lista de las membresías de un espacio. Para ver un ejemplo, consulta Enumera los usuarios y las apps de Google Chat en un espacio. Ficha de membresías con autenticación de app indica las membresías en espacios a los que la app de Chat tiene acceso, pero excluye las membresías de la app de Chat, incluidas las propias. Enumerar membresías con Autenticación de usuarios indica las membresías en los espacios a los que tiene acceso el usuario autenticado.

Requiere autenticación. Admite la autenticación de apps y la autenticación de usuarios.

Solicitud HTTP

GET https://chat.googleapis.com/v1/{parent=spaces/*}/members

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El nombre del recurso del espacio para el que se recuperará una lista de membresías.

Formato: spaces/{space}

Parámetros de consulta

Parámetros
pageSize

integer

Opcional. La cantidad máxima de membresías que se mostrarán. Es posible que el servicio muestre menos valores que este.

Si no se especifica, se muestran 100 membresías como máximo.

El valor máximo es 1,000. Si usas un valor superior a 1,000, este se cambia automáticamente a 1,000.

Los valores negativos muestran un error INVALID_ARGUMENT.

pageToken

string

Opcional. Un token de página, recibido de una llamada anterior para enumerar membresías. Proporciona este parámetro para recuperar la página siguiente.

Durante la paginación, todos los demás parámetros proporcionados deben coincidir con la llamada que proporcionó el token de la página. Pasar valores diferentes a los otros parámetros puede generar resultados inesperados.

filter

string

Opcional. Un filtro de consulta

Puedes filtrar las membresías por el rol (role) y el tipo (member.type) de un miembro.

Para filtrar por función, establece role en ROLE_MEMBER o ROLE_MANAGER.

Para filtrar por tipo, establece member.type en HUMAN o BOT. También puedes filtrar por member.type con el operador !=.

Para filtrar por función y tipo, usa el operador AND. Para filtrar por función o tipo, usa el operador OR.

Se requiere member.type = "HUMAN" o member.type != "BOT" cuando useAdminAccess se configura como verdadero. Se rechazarán los demás filtros de tipos de miembros.

Por ejemplo, las siguientes consultas son válidas:

role = "ROLE_MANAGER" OR role = "ROLE_MEMBER"
member.type = "HUMAN" AND role = "ROLE_MANAGER"

member.type != "BOT"

Las siguientes consultas no son válidas:

member.type = "HUMAN" AND member.type = "BOT"
role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"

El servidor rechaza las consultas no válidas con un error INVALID_ARGUMENT.

showGroups

boolean

Opcional. Cuando es true, también muestra membresías asociadas con un Google Group, además de otros tipos de membresías. Si se establece un filter, no se muestran las membresías de Google Group que no coinciden con los criterios del filtro.

showInvited

boolean

Opcional. Cuando true, también muestra membresías asociadas con los miembros de invited, además de otros tipos de membresías. Si se configura un filtro, no se mostrarán las membresías de invited que no coinciden con los criterios del filtro.

Actualmente requiere la autenticación de usuarios.

useAdminAccess

boolean

Cuando es true, el método se ejecuta con los privilegios de administrador de Google Workspace del usuario.

El usuario que realiza la llamada debe ser administrador de Google Workspace con el privilegio para administrar el chat y las conversaciones de los espacios.

Requiere el permiso de OAuth 2.0 chat.admin.memberships.readonly o chat.admin.memberships.

No se admite enumerar las membresías de apps en un espacio cuando se usa el acceso de administrador.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es una respuesta para enumerar las membresías del espacio.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "memberships": [
    {
      object (Membership)
    }
  ],
  "nextPageToken": string
}
Campos
memberships[]

object (Membership)

Lista sin ordenar. Es la lista de membresías en la página solicitada (o primera).

nextPageToken

string

Un token que puedes enviar como pageToken para recuperar la siguiente página de resultados. Si está vacío, no hay páginas posteriores.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships.readonly
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

Para obtener más información, consulta la Guía de autorización.