- 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 événements d'un espace Google Chat. Pour chaque événement, la payload contient la version la plus récente de la ressource Chat. Par exemple, si vous répertoriez des événements concernant les nouveaux membres d'un espace, le serveur renvoie les ressources Membership
contenant les derniers détails d'appartenance. Si de nouveaux membres ont été supprimés au cours de la période demandée, la charge utile de l'événement contient une ressource Membership
vide.
Nécessite une authentification utilisateur. Pour répertorier les événements, l'utilisateur authentifié doit être membre de l'espace.
Pour obtenir un exemple, consultez Répertorier les événements d'un espace Google Chat.
Requête HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents
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 Google Chat dans lequel les événements se sont produits. Format : |
Paramètres de requête
Paramètres | |
---|---|
pageSize |
Facultatif. Nombre maximal d'événements d'espace renvoyés. Le service peut renvoyer une valeur inférieure à cette valeur. Les valeurs négatives renvoient une erreur |
pageToken |
Jeton de page, reçu lors d'un précédent appel d'événements d'espace de liste. Fournissez-le pour récupérer la page suivante. Lors de la pagination, tous les autres paramètres fournis pour répertorier les événements d'espace 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 |
Obligatoire. Un filtre de requête. Vous devez spécifier au moins un type d'événement ( Vous pouvez également filtrer par heure de début (
Pour spécifier une heure de début ou de fin, utilisez l'opérateur "est égal(e) à Par exemple, les requêtes suivantes sont valides:
Les requêtes suivantes ne sont pas valides:
Les requêtes non valides sont rejetées par le serveur avec une erreur |
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 événements de l'espace.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{
"spaceEvents": [
{
object ( |
Champs | |
---|---|
spaceEvents[] |
Les résultats sont renvoyés dans l'ordre chronologique (l'événement le plus ancien en premier). |
nextPageToken |
Jeton de continuité utilisé pour récupérer d'autres événements. 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.spaces
https://www.googleapis.com/auth/chat.spaces.readonly
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.readonly
https://www.googleapis.com/auth/chat.messages.reactions
https://www.googleapis.com/auth/chat.messages.reactions.readonly
Pour en savoir plus, consultez le guide relatif aux autorisations.