REST Resource: users.sections

Recurso: Sección

Representa una sección en Google Chat. Las secciones ayudan a los usuarios a organizar sus espacios. Existen dos tipos de secciones:

  1. Secciones del sistema: Son secciones predefinidas que administra Google Chat. Sus nombres de recursos son fijos y no se pueden crear, borrar ni modificar sus displayName. Los siguientes son algunos ejemplos:

    • users/{user}/sections/default-direct-messages
    • users/{user}/sections/default-spaces
    • users/{user}/sections/default-apps
  2. Secciones personalizadas: Son secciones que crea y administra el usuario. Crear una sección personalizada con sections.create requiere un displayName. Las secciones personalizadas se pueden actualizar con sections.patch y borrar con sections.delete.

Representación JSON
{
  "name": string,
  "displayName": string,
  "sortOrder": integer,
  "type": enum (SectionType)
}
Campos
name

string

Es el identificador. Es el nombre del recurso de la sección.

En el caso de las secciones del sistema, el ID de sección es una cadena constante:

  • DEFAULT_DIRECT_MESSAGES: users/{user}/sections/default-direct-messages
  • DEFAULT_SPACES: users/{user}/sections/default-spaces
  • DEFAULT_APPS: users/{user}/sections/default-apps

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

displayName

string

Obligatorio. Es el nombre visible de la sección. Solo se completa para las secciones de tipo CUSTOM_SECTION. Admite hasta 80 caracteres. Se requiere cuando se crea un CUSTOM_SECTION.

sortOrder

integer

Solo salida. Es el orden de la sección en relación con otras secciones. Las secciones con un valor de sortOrder más bajo aparecen antes que las secciones con un valor más alto.

type

enum (SectionType)

Obligatorio. Es el tipo de sección.

SectionType

Tipos de secciones.

Enums
SECTION_TYPE_UNSPECIFIED Es un tipo de sección sin especificar.
CUSTOM_SECTION Sección personalizada.
DEFAULT_DIRECT_MESSAGES Sección predeterminada que contiene DIRECT_MESSAGE entre dos usuarios humanos o espacios de GROUP_CHAT que no pertenecen a ninguna sección personalizada.
DEFAULT_SPACES Son los espacios predeterminados que no pertenecen a ninguna sección personalizada.
DEFAULT_APPS Sección predeterminada que contiene las apps instaladas de un usuario.

Métodos

create

Crea una sección en Google Chat.

delete

Borra una sección de tipo CUSTOM_SECTION.

list

Enumera las secciones disponibles para el usuario de Chat.

patch

Actualiza una sección.

position

Cambia el orden de clasificación de una sección.