REST Resource: users.sections

• Recurso: Sección
  • Representación JSON
• SectionType
• Métodos

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.

   Versión preliminar para desarrolladores: Disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones.

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	Versión preliminar para desarrolladores: Disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones. Crea una sección en Google Chat.
delete	Versión preliminar para desarrolladores: Disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones. Borra una sección de tipo CUSTOM_SECTION.
list	Versión preliminar para desarrolladores: Disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones. Enumera las secciones disponibles para el usuario de Chat.
patch	Versión preliminar para desarrolladores: Disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones. Actualiza una sección.
position	Versión preliminar para desarrolladores: Disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones. Cambia el orden de clasificación de una sección.