Method: users.sections.list

Liste les sections disponibles pour l'utilisateur Chat. Les sections aident les utilisateurs à regrouper leurs conversations et à personnaliser la liste des espaces affichés dans le panneau de navigation Chat. Pour en savoir plus, consultez Créer et organiser des sections dans Google Chat.

Nécessite une authentification de l'utilisateur avec le champ d'application de l'autorisation :

  • 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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Parent, qui est le nom de ressource utilisateur propriétaire de cette collection de sections. Ne prend en charge que les sections de la liste pour l'utilisateur appelant. Pour faire référence à l'utilisateur appelant, définissez l'un des éléments suivants :

  • Alias me. Exemple :users/me

  • Son adresse e-mail Workspace Par exemple : users/user@example.com.

  • Son ID utilisateur. Par exemple : users/123456789.

Format : users/{user}

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Nombre maximal de sections à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur.

Si aucune valeur n'est spécifiée, un maximum de 10 sections est affiché.

La valeur maximale est de 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 de liste des sections précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis doivent correspondre à l'appel ayant fourni le jeton de page. Transmettre différentes valeurs aux autres paramètres peut entraîner des résultats inattendus.

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 sections.

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

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

object (Section)

Sections de l'utilisateur spécifié.
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.

Champs d'application 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 d'autorisation.