Method: users.sections.items.list

Listet Elemente in einem Abschnitt auf.

Derzeit können nur Gruppenbereiche Abschnittselemente sein. Weitere Informationen finden Sie unter Bereiche in Google Chat erstellen und organisieren.

Erfordert Nutzerauthentifizierung mit dem Autorisierungsbereich:

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly

HTTP-Anfrage

GET https://chat.googleapis.com/v1/{parent=users/*/sections/*}/items

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das übergeordnete Element, also der Ressourcenname des Abschnitts, zu dem diese Sammlung von Abschnittselementen gehört. Es werden nur Listenelemente für den aufrufenden Nutzer unterstützt.

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

Suchparameter

Parameter
pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden Bereichselemente. Der Dienst gibt möglicherweise weniger als diesen Wert zurück.

Falls nicht angegeben, werden maximal 10 Bereichselemente zurückgegeben.

Der Höchstwert ist 100. Wenn Sie einen Wert über 100 verwenden, wird er automatisch in 100 geändert.

Bei negativen Werten wird ein INVALID_ARGUMENT-Fehler zurückgegeben.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen Aufruf zum Auflisten von Abschnittselementen empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Wenn Sie für die anderen Parameter unterschiedliche Werte übergeben, kann das zu unerwarteten Ergebnissen führen.
filter

string

Optional. Ein Abfragefilter.

Derzeit wird nur das Filtern nach Arbeitsbereich unterstützt.

Beispiel: space = spaces/{space}.

Ungültige Anfragen werden mit dem Fehler INVALID_ARGUMENT abgelehnt.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für das Auflisten von Abschnittselementen.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "sectionItems": [
    {
      object (SectionItem)
    }
  ],
  "nextPageToken": string
}
Felder
sectionItems[]

object (SectionItem)

Die Abschnittselemente aus dem angegebenen Abschnitt.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly

Weitere Informationen finden Sie im Autorisierungsleitfaden.