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 et ne peuvent pas être créés, supprimés ni modifiés dans displayName. Voici quelques exemples :

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

  2. Sections personnalisées : il s'agit de sections créées et gérées par l'utilisateur. Pour créer une section personnalisée à l'aide de sections.create, un displayName est obligatoire. Les sections personnalisées peuvent être mises à jour à l'aide de sections.patch et supprimées à 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

Facultatif. Nom à afficher de la section. Renseigné uniquement pour les sections de type CUSTOM_SECTION. Jusqu'à 80 caractères. Obligatoire lors de la création d'une 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 la 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 des DIRECT_MESSAGE entre deux utilisateurs humains ou des espaces GROUP_CHAT n'appartenant à aucune section personnalisée.
DEFAULT_SPACES Espaces par défaut n'appartenant à aucune section personnalisée.
DEFAULT_APPS Section par défaut contenant les applications installées d'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.