REST Resource: users.sections

Ressource: Abschnitt

Stellt einen Bereich in Google Chat dar. Mit Abschnitten können Nutzer ihre Projektbereiche organisieren. Es gibt zwei Arten von Abschnitten:

  1. Systemabschnitte:Das sind vordefinierte Abschnitte, die von Google Chat verwaltet werden. Die Ressourcennamen sind festgelegt und können nicht erstellt, gelöscht oder geändert werden.displayName Beispiele:

    • users/{user}/sections/default-direct-messages
    • users/{user}/sections/default-spaces
    • users/{user}/sections/default-apps
  2. Benutzerdefinierte Bereiche:Diese Bereiche werden vom Nutzer erstellt und verwaltet. Wenn Sie einen benutzerdefinierten Abschnitt mit sections.create erstellen, ist eine displayName erforderlich. Benutzerdefinierte Bereiche können mit sections.patch aktualisiert und mit sections.delete gelöscht werden.

JSON-Darstellung
{
  "name": string,
  "displayName": string,
  "sortOrder": integer,
  "type": enum (SectionType)
}
Felder
name

string

ID. Ressourcenname des Abschnitts.

Bei Systemabschnitten ist die Abschnitts-ID ein konstanter String:

  • 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

Erforderlich. Der Anzeigename des Bereichs. Wird nur für Abschnitte vom Typ CUSTOM_SECTION ausgefüllt. Unterstützt bis zu 80 Zeichen. Erforderlich beim Erstellen eines CUSTOM_SECTION.

sortOrder

integer

Nur Ausgabe. Die Reihenfolge des Abschnitts im Verhältnis zu anderen Abschnitten. Abschnitte mit einem niedrigeren sortOrder-Wert werden vor Abschnitten mit einem höheren Wert angezeigt.

type

enum (SectionType)

Erforderlich. Der Typ des Abschnitts.

SectionType

Abschnittstypen.

Enums
SECTION_TYPE_UNSPECIFIED Nicht angegebener Abschnittstyp.
CUSTOM_SECTION Benutzerdefinierter Bereich
DEFAULT_DIRECT_MESSAGES Standardabschnitt mit DIRECT_MESSAGE zwischen zwei menschlichen Nutzern oder GROUP_CHAT-Bereichen, die zu keinem benutzerdefinierten Abschnitt gehören.
DEFAULT_SPACES Standardbereiche, die zu keinem benutzerdefinierten Bereich gehören.
DEFAULT_APPS Standardabschnitt mit den installierten Apps eines Nutzers.

Methoden

create

Erstellt einen Bereich in Google Chat.

delete

Löscht einen Abschnitt vom Typ CUSTOM_SECTION.

list

Listet die Abschnitte auf, die für den Chat-Nutzer verfügbar sind.

patch

Aktualisiert einen Abschnitt.

position

Ändert die Sortierreihenfolge eines Abschnitts.