Method: users.sections.items.list

Liste les éléments d'une section.

Seuls les espaces peuvent être des éléments de section. Pour en savoir plus, consultez Créer et organiser des sections dans Google Chat.

Nécessite l'authentification de l'utilisateur avec le niveau d'accès de l'autorisation suivant :

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

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Parent, qui correspond au nom de la ressource de section propriétaire de cette collection d'éléments de section. Ne permet de lister les éléments de section que pour l'utilisateur appelant.

Lorsque vous filtrez par espace, utilisez le caractère générique - pour effectuer une recherche dans toutes les sections. Par exemple, users/{user}/sections/-.

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

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Nombre maximal d'éléments de section à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur.

Si aucune valeur n'est spécifiée, 10 éléments de section au maximum sont renvoyés.

La valeur maximale est 100. Si vous utilisez une valeur supérieure à 100, elle est automatiquement remplacée par 100.

Les valeurs négatives renvoient une erreur INVALID_ARGUMENT.
pageToken

string

Facultatif. Jeton de page reçu d'un appel précédent pour lister les éléments de section. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis doivent correspondre à l'appel qui a fourni le jeton de page. Si vous transmettez des valeurs différentes aux autres paramètres, les résultats peuvent être inattendus.
filter

string

Facultatif. Filtre de requête.

Actuellement, seul le filtrage par espace est pris en charge.

Par exemple, space = spaces/{space}.

Les requêtes non valides sont rejetées avec une erreur INVALID_ARGUMENT.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour la liste des éléments de section.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "sectionItems": [
    {
      object (SectionItem)
    }
  ],
  "nextPageToken": string
}
Champs
sectionItems[]

object (SectionItem)

Éléments de section de la section spécifiée.
nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez le guide sur l'autorisation.