REST Resource: users.sections

Risorsa: Sezione

Rappresenta una sezione in Google Chat. Le sezioni aiutano gli utenti a organizzare i propri spazi. Esistono due tipi di sezioni:

  1. Sezioni di sistema:si tratta di sezioni predefinite gestite da Google Chat. I nomi delle risorse sono fissi e non possono essere creati, eliminati o modificati displayName. Ecco alcuni esempi:

    • users/{user}/sections/default-direct-messages
    • users/{user}/sections/default-spaces
    • users/{user}/sections/default-apps
  2. Sezioni personalizzate:si tratta di sezioni create e gestite dall'utente. La creazione di una sezione personalizzata utilizzando sections.create richiede un displayName. Le sezioni personalizzate possono essere aggiornate utilizzando sections.patch ed eliminate utilizzando sections.delete.

Rappresentazione JSON
{
  "name": string,
  "displayName": string,
  "sortOrder": integer,
  "type": enum (SectionType)
}
Campi
name

string

Identificatore. Nome risorsa della sezione.

Per le sezioni di sistema, l'ID sezione è una stringa costante:

  • 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

Obbligatorio. Il nome visualizzato della sezione. Compilato solo per le sezioni di tipo CUSTOM_SECTION. Supporta fino a 80 caratteri. Obbligatorio durante la creazione di un CUSTOM_SECTION.

sortOrder

integer

Solo output. L'ordine della sezione rispetto alle altre sezioni. Le sezioni con un valore sortOrder inferiore vengono visualizzate prima di quelle con un valore superiore.

type

enum (SectionType)

Obbligatorio. Il tipo di sezione.

SectionType

Tipi di sezioni.

Enum
SECTION_TYPE_UNSPECIFIED Tipo di sezione non specificato.
CUSTOM_SECTION Sezione personalizzata.
DEFAULT_DIRECT_MESSAGES Sezione predefinita contenente DIRECT_MESSAGE tra due utenti umani o spazi GROUP_CHAT che non appartengono a nessuna sezione personalizzata.
DEFAULT_SPACES Spazi predefiniti che non appartengono a nessuna sezione personalizzata.
DEFAULT_APPS Sezione predefinita contenente le app installate di un utente.

Metodi

create

Crea una sezione in Google Chat.

delete

Elimina una sezione di tipo CUSTOM_SECTION.

list

Elenca le sezioni disponibili per l'utente di Chat.

patch

Aggiorna una sezione.

position

Modifica l'ordinamento di una sezione.