Method: spaces.spaceEvents.list

Liste les événements d'un espace Google Chat. Pour chaque événement, la charge utile contient la version la plus récente de la ressource Chat. Par exemple, si vous listez des événements concernant de nouveaux membres d'un espace, le serveur renvoie des ressources Membership contenant les dernières informations sur les membres. 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.

Les types d'authentification suivants sont acceptés avec un champ d'application de l'autorisation approprié pour lire les données demandées :

  • Authentification de l'application avec approbation de l'administrateur dans la version Preview développeur avec l'un des champs d'application d'autorisation suivants :

    • https://www.googleapis.com/auth/chat.app.spaces
    • https://www.googleapis.com/auth/chat.app.messages.readonly
    • https://www.googleapis.com/auth/chat.app.memberships

  • Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants :

    • https://www.googleapis.com/auth/chat.spaces.readonly
    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.messages.readonly
    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.messages.reactions.readonly
    • https://www.googleapis.com/auth/chat.messages.reactions
    • https://www.googleapis.com/auth/chat.memberships.readonly
    • https://www.googleapis.com/auth/chat.memberships

Pour lister les événements, l'appelant authentifié doit être membre de l'espace.

Pour obtenir un exemple, consultez Lister 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

string

Obligatoire. Nom de ressource de l'espace Google Chat où les événements se sont produits.

Format : spaces/{space}.

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Nombre maximal d'événements d'espace renvoyés. Le service peut renvoyer un nombre inférieur à cette valeur.

Les valeurs négatives renvoient une erreur INVALID_ARGUMENT.
pageToken

string

Facultatif. Jeton de page reçu d'un appel de liste des événements d'espace précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à la liste des événements d'espace 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.
filter

string

Obligatoire. Filtre de requête.

Vous devez spécifier au moins un type d'événement (eventType) à l'aide de l'opérateur :. Pour filtrer les données par plusieurs types d'événements, utilisez l'opérateur OR. Omettez les types d'événements par lot dans votre filtre. La requête renvoie automatiquement tous les événements de lot associés. Par exemple, si vous filtrez par nouvelles réactions (google.workspace.chat.reaction.v1.created), le serveur renvoie également des événements de nouvelles réactions par lot (google.workspace.chat.reaction.v1.batchCreated). Pour obtenir la liste des types d'événements acceptés, consultez la documentation de référence SpaceEvents.

Vous pouvez également filtrer par heure de début (startTime) et heure de fin (endTime) :

  • startTime : horodatage exclusif à partir duquel commencer à lister les événements de l'espace. Vous pouvez lister les événements survenus jusqu'à 28 jours auparavant. Si aucune date n'est spécifiée, la commande liste les événements de l'espace au cours des 28 derniers jours.
  • endTime : horodatage inclusif jusqu'auquel les événements de l'espace sont listés. Si aucune valeur n'est spécifiée, la liste des événements s'arrête à l'heure de la requête.

Pour spécifier une heure de début ou de fin, utilisez l'opérateur égal à = et le format RFC-3339. Pour filtrer par startTime et endTime, utilisez l'opérateur AND.

Par exemple, les requêtes suivantes sont valides :

startTime="2023-08-23T19:20:33+00:00" AND
endTime="2023-08-23T19:21:54+00:00"

startTime="2023-08-23T19:20:33+00:00" AND
(eventTypes:"google.workspace.chat.space.v1.updated" OR
eventTypes:"google.workspace.chat.message.v1.created")

Les requêtes suivantes ne sont pas valides :

startTime="2023-08-23T19:20:33+00:00" OR
endTime="2023-08-23T19:21:54+00:00"

eventTypes:"google.workspace.chat.space.v1.updated" AND
eventTypes:"google.workspace.chat.message.v1.created"

Les requêtes non valides sont rejetées par le serveur 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 événements d'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 (SpaceEvent)
    }
  ],
  "nextPageToken": string
}
Champs
spaceEvents[]

object (SpaceEvent)

Les résultats sont renvoyés par ordre chronologique (l'événement le plus ancien en premier). Remarque : Le champ permissionSettings n'est pas renvoyé dans l'objet Space pour les requêtes de liste.
nextPageToken

string

Jeton de continuation 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.app.memberships
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • 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 d'autorisation.