Method: spaces.findGroupChats

Devuelve todos los espacios con spaceType == GROUP_CHAT, cuyas membresías humanas contienen exactamente al usuario que llama y a los usuarios especificados en FindGroupChatsRequest.memberships.

Si el usuario que llama bloquea a algunos usuarios o está bloqueado por ellos, y no se encuentran espacios con el conjunto completo de usuarios especificado, este método devuelve espacios que no incluyen a los usuarios bloqueados o que bloquean.

El conjunto de usuarios especificado solo debe contener membresías de personas (no de aplicaciones). Una solicitud que contiene usuarios no humanos no devuelve ningún espacio.

Requiere autenticación del usuario con uno de los siguientes alcances de autorización:

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

Solicitud HTTP

GET https://chat.googleapis.com/v1/spaces:findGroupChats

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

Parámetros de consulta

Parámetros
user[]

string

Son los nombres de recursos de todos los usuarios humanos en el chat grupal con el usuario que llama. Las apps de chat no se pueden incluir en la solicitud.

Formato: users/{user}, donde {user} es el id de la persona de la API de People o el id del usuario en la API de Directory. Por ejemplo, para encontrar todos los chats grupales con el usuario que llama y otros dos usuarios, con los IDs de perfil de la API de People 123456789 y 987654321, puedes usar users/123456789 y users/987654321. También puedes usar el correo electrónico como alias para {user}. Por ejemplo, users/example@gmail.com, donde example@gmail.com es el correo electrónico del usuario de Google Chat.

Cuando el usuario que llama es un usuario de Google Workspace, todos los usuarios solicitados deben ser miembros de la misma organización de Google Workspace que el usuario que llama.
pageSize

integer

Opcional. Es la cantidad máxima de espacios que se devolverán. El servicio puede devolver una cantidad inferior a este valor.

Si no se especifica, se devolverán, como máximo, 100 espacios.

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

Los valores negativos muestran un error INVALID_ARGUMENT.
pageToken

string

Opcional. Es un token de página que se recibió de una llamada anterior para encontrar chats de grupo. Proporciona este parámetro para recuperar la página siguiente.

Cuando se realiza la paginación, todos los demás parámetros proporcionados deben coincidir con la llamada que proporcionó el token. Si pasas valores diferentes, es posible que se generen resultados inesperados.
spaceView

enum (SpaceView)

Es el tipo de vista de espacio solicitado. Si no se configura, el valor predeterminado es SPACE_VIEW_RESOURCE_NAME_ONLY. Las solicitudes que especifican SPACE_VIEW_EXPANDED deben incluir permisos que permitan leer datos de espacios, por ejemplo, https://www.googleapis.com/auth/chat.spaces o https://www.googleapis.com/auth/chat.spaces.readonly.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es una respuesta que contiene espacios de chat en grupo con exactamente el usuario que llama y los usuarios solicitados.

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

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

object (Space)

Es la lista de espacios en la página solicitada (o en la primera).
nextPageToken

string

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

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • 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.

SpaceView

Es una vista que especifica qué campos se deben completar en el recurso Space. Para garantizar la compatibilidad con versiones futuras, te recomendamos que tu código tenga en cuenta valores adicionales.

Enums
SPACE_VIEW_UNSPECIFIED Es el valor predeterminado o no establecido.
SPACE_VIEW_RESOURCE_NAME_ONLY Solo propaga el nombre del recurso del espacio.
SPACE_VIEW_EXPANDED Propaga los campos del recurso de Space. Nota: El campo permissionSettings no se propagará. Las solicitudes que especifican SPACE_VIEW_EXPANDED deben incluir permisos que permitan leer datos de espacios, por ejemplo, https://www.googleapis.com/auth/chat.spaces o https://www.googleapis.com/auth/chat.spaces.readonly.