- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
Répertorie les messages d'un espace dont l'appelant est membre, y compris ceux des membres bloqués et des espaces. Pour obtenir un exemple, consultez Lister les messages. Nécessite une authentification utilisateur.
Requête HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/messages
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
parent |
Obligatoire. Nom de ressource de l'espace à partir duquel répertorier les messages. Format : |
Paramètres de requête
Paramètres | |
---|---|
pageSize |
Nombre maximal de messages renvoyés. Le service peut renvoyer un nombre de messages inférieur à cette valeur. Si aucune valeur n'est spécifiée, un maximum de 25 unités est renvoyé. La valeur maximale est 1 000. Si vous utilisez une valeur supérieure à 1 000, elle passe automatiquement à 1 000. Les valeurs négatives renvoient une erreur |
pageToken |
Facultatif en cas de reprise d'une requête précédente. Jeton de page reçu à partir d'un appel de liste précédent. Indiquez ce paramètre 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. La transmission de valeurs différentes aux autres paramètres peut entraîner des résultats inattendus. |
filter |
Un filtre de requête. Vous pouvez filtrer les messages par date ( Pour filtrer les messages en fonction de la date de création, spécifiez Pour filtrer par thread, spécifiez le Pour filtrer par fil de discussion et par date, utilisez l'opérateur Par exemple, les requêtes suivantes sont valides:
Les requêtes non valides sont rejetées par le serveur avec une erreur |
orderBy |
Facultatif en cas de reprise d'une requête précédente. Comment la liste des messages est-elle triée ? Spécifiez une valeur à trier par opération de tri. Les valeurs valides pour les opérations de tri sont les suivantes:
L'ordre par défaut est |
showDeleted |
Indique si les messages supprimés doivent être inclus. Les messages supprimés incluent l'heure de suppression et les métadonnées associées, mais leur contenu n'est pas disponible. |
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Message de réponse pour les messages listés.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{
"messages": [
{
object ( |
Champs | |
---|---|
messages[] |
Liste de messages. |
nextPageToken |
Vous pouvez envoyer un jeton en tant que |
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
Pour en savoir plus, consultez le guide relatif aux autorisations.