REST Resource: users.sections

Ressource : Section

Représente une section dans Google Chat. Les sections aident les utilisateurs à organiser leurs espaces. Il existe deux types de sections :

  1. Sections système : il s'agit de sections prédéfinies gérées par Google Chat. Leurs noms de ressources sont fixes. Vous ne pouvez pas les créer ni les supprimer, ni modifier leur displayName. Voici quelques exemples :

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

  2. Sections personnalisées : sections créées et gérées par l'utilisateur. Pour créer une section personnalisée à l'aide de sections.create, vous devez utiliser displayName. Vous pouvez mettre à jour les sections personnalisées à l'aide de sections.patch et les supprimer à l'aide de sections.delete.

Représentation JSON 
{
  "name": string,
  "displayName": string,
  "sortOrder": integer,
  "type": enum (SectionType)
}
Champs
name

string

Identifiant. Nom de ressource de la section.

Pour les sections système, l'ID de section est une chaîne constante :

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

Format : users/{user}/sections/{section}
displayName

string

Obligatoire. Nom à afficher de la section. Renseigné uniquement pour les sections de type CUSTOM_SECTION. Il peut contenir jusqu'à 80 caractères. Obligatoire lors de la création d'un CUSTOM_SECTION.
sortOrder

integer

Uniquement en sortie. Ordre de la section par rapport aux autres sections. Les sections dont la valeur sortOrder est inférieure apparaissent avant celles dont la valeur est supérieure.
type

enum (SectionType)

Obligatoire. Type de section.

SectionType

Types de sections.

Enums
SECTION_TYPE_UNSPECIFIED Type de section non spécifié.
CUSTOM_SECTION Section personnalisée.
DEFAULT_DIRECT_MESSAGES Section par défaut contenant les espaces DIRECT_MESSAGE entre deux utilisateurs humains ou les espaces GROUP_CHAT qui n'appartiennent à aucune section personnalisée.
DEFAULT_SPACES Espaces par défaut qui n'appartiennent à aucune section personnalisée.
DEFAULT_APPS Section par défaut contenant les applications installées par un utilisateur.

Méthodes

create

 Crée une section dans Google Chat.

delete

 Supprime une section de type CUSTOM_SECTION.

list

 Liste les sections disponibles pour l'utilisateur Chat.

patch

 Met à jour une section.

position

 Modifie l'ordre de tri d'une section.