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 su 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. Para crear una sección personalizada con sections.create, se 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.

Para las secciones del sistema, el ID de la 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

Es opcional. Es el nombre visible de la sección. Solo se completa para las secciones de tipo CUSTOM_SECTION. Admite hasta 80 caracteres. Es obligatorio 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 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 Indica un tipo de sección no especificado.
CUSTOM_SECTION Indica una sección personalizada.
DEFAULT_DIRECT_MESSAGES Indica la sección predeterminada que contiene DIRECT_MESSAGE entre dos usuarios humanos o espacios GROUP_CHAT que no pertenecen a ninguna sección personalizada.
DEFAULT_SPACES Indica los espacios predeterminados que no pertenecen a ninguna sección personalizada.
DEFAULT_APPS Indica la 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

 Muestra las secciones disponibles para el usuario de Chat.

patch

 Actualiza una sección.

position

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