- 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
Liste les messages d'un espace dont l'appelant est membre, y compris les messages des membres et des espaces bloqués. Si vous répertoriez les messages d'un espace sans messages, la réponse est un objet vide. Lorsque vous utilisez une interface REST/HTTP, la réponse contient un objet JSON vide, {}
. Pour obtenir un exemple, consultez la section Lister les messages.
Authentification des utilisateurs requise.
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 | |
---|---|
page |
Nombre maximal de messages renvoyés. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 25 valeurs au maximum sont renvoyées. La valeur maximale est 1 000. Si vous utilisez une valeur supérieure à 1 000, elle est automatiquement remplacée par 1 000. Les valeurs négatives renvoient une erreur |
page |
Facultatif, si vous reprenez à partir d'une requête précédente. Jeton de page reçu lors d'un appel de liste de messages précédent. Fournissez 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. Transmettre des 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 leur 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 |
order |
Facultatif, si vous reprenez une requête précédente. Ordre de la liste des messages. Spécifiez une valeur à trier par une opération de tri. Les valeurs valides pour les opérations de tri sont les suivantes:
L'ordre par défaut est |
show |
Permet d'inclure ou non les messages supprimés. Les messages supprimés incluent l'heure et les métadonnées concernant leur suppression, 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 la liste des messages.
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 des messages. |
next |
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 d'autorisation.