Method: users.sections.items.list

Listet Elemente in einem Abschnitt auf.

Nur Gruppenbereiche können Abschnittselemente sein. Weitere Informationen finden Sie unter Abschnitte 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, das der Ressourcenname des Abschnitts ist, der diese Sammlung von Abschnittselementen besitzt. Unterstützt nur das Auflisten von Abschnittselementen für den aufrufenden Nutzer.

Wenn Sie nach Gruppenbereich filtern, verwenden Sie das Platzhalterzeichen -, um in allen Abschnitten zu suchen. Beispiel: users/{user}/sections/-.

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

Suchparameter

Parameter
pageSize

integer

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

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

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

Negative Werte führen zu einem INVALID_ARGUMENT-Fehler.
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 dies zu unerwarteten Ergebnissen führen.
filter

string

Optional. Ein Abfragefilter.

Derzeit wird nur das Filtern nach Gruppenbereich unterstützt.

Beispiel: space = spaces/{space}.

Ungültige Abfragen werden mit einem INVALID_ARGUMENT-Fehler abgelehnt.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht zum 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.