Method: users.sections.items.list

Enumera los elementos de una sección.

Actualmente, solo los espacios pueden ser elementos de sección. Para obtener más información, consulta Crea y organiza secciones en Google Chat.

Requiere autenticación del usuario con el alcance de autorización:

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly

Solicitud HTTP

GET https://chat.googleapis.com/v1/{parent=users/*/sections/*}/items

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

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el elemento superior, que es el nombre del recurso de la sección que posee esta colección de elementos de sección. Solo admite elementos de la sección de la lista para el usuario que llama.

Formato: users/{user}/sections/{section}

Parámetros de consulta

Parámetros
pageSize

integer

Opcional. Es la cantidad máxima de elementos de sección que se devolverán. El servicio puede mostrar menos que este valor.

Si no se especifica, se devolverán, como máximo, 10 elementos de sección.

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

Los valores negativos muestran un error INVALID_ARGUMENT.
pageToken

string

Opcional. Es un token de página que se recibió de una llamada a list section items anterior. Proporciona esto 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 de página. Si pasas valores diferentes a los otros parámetros, es posible que obtengas resultados inesperados.
filter

string

Opcional. Es un filtro de consulta.

Actualmente, solo se admite el filtrado por espacio.

Por ejemplo, space = spaces/{space}.

Las consultas no válidas se rechazan con un error INVALID_ARGUMENT.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es el mensaje de respuesta para enumerar los elementos de la sección.

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

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

object (SectionItem)

Son los elementos de la sección especificada.
nextPageToken

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly

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