REST Resource: users.sections

Recurso: Section

Representa uma seção no Google Chat. As seções ajudam os usuários a organizar os espaços. Há dois tipos de seções:

  1. Seções do sistema:são seções predefinidas gerenciadas pelo Google Chat. Os nomes de recursos são fixos e não podem ser criados, excluídos ou ter o displayName modificado. Por exemplo:

    • users/{user}/sections/default-direct-messages
    • users/{user}/sections/default-spaces
    • users/{user}/sections/default-apps

  2. Seções personalizadas:são seções criadas e gerenciadas pelo usuário. Para criar uma seção personalizada usando sections.create, é necessário um displayName. As seções personalizadas podem ser atualizadas usando sections.patch e excluídas usando sections.delete.

Representação JSON 
{
  "name": string,
  "displayName": string,
  "sortOrder": integer,
  "type": enum (SectionType)
}
Campos
name

string

Identificador. Nome do recurso da seção.

Para seções do sistema, o ID é uma string 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

Obrigatório. O nome de exibição da seção. Preenchido apenas para seções do tipo CUSTOM_SECTION. Aceita até 80 caracteres. Obrigatório ao criar um CUSTOM_SECTION.
sortOrder

integer

Apenas saída. A ordem da seção em relação a outras seções. As seções com um valor sortOrder menor aparecem antes das seções com um valor maior.
type

enum (SectionType)

Obrigatório. O tipo da seção.

SectionType

Tipos de seção.

Tipos enumerados
SECTION_TYPE_UNSPECIFIED Tipo de seção não especificado.
CUSTOM_SECTION Seção personalizada.
DEFAULT_DIRECT_MESSAGES Seção padrão que contém DIRECT_MESSAGE entre dois usuários humanos ou espaços de GROUP_CHAT que não pertencem a nenhuma seção personalizada.
DEFAULT_SPACES Espaços padrão que não pertencem a nenhuma seção personalizada.
DEFAULT_APPS Seção padrão que contém os apps instalados de um usuário.

Métodos

create

 Cria uma seção no Google Chat.

delete

 Exclui uma seção do tipo CUSTOM_SECTION.

list

 Lista as seções disponíveis para o usuário do Chat.

patch

 Atualiza uma seção.

position

 Muda a ordem de classificação de uma seção.