Method: users.sections.list

Enumera las secciones disponibles para el usuario de Chat. Las secciones ayudan a los usuarios a agrupar sus conversaciones y personalizar la lista de espacios que se muestra en el panel de navegación de Chat. 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

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

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el recurso principal, que es el nombre del recurso del usuario propietario de esta colección de secciones. Solo admite secciones de la lista para el usuario que llama. Para hacer referencia al usuario que llama, establece uno de los siguientes parámetros:

  • Es el alias de me. Por ejemplo, users/me

  • Su dirección de correo electrónico de Workspace Por ejemplo, users/user@example.com.

  • Su ID de usuario Por ejemplo, users/123456789.

Formato: users/{user}

Parámetros de consulta

Parámetros
pageSize

integer

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

Si no se especifica, se devolverán, como máximo, 10 secciones.

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

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es el mensaje de respuesta para enumerar secciones.

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

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

object (Section)

Son las secciones del usuario especificado.
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.