- Richiesta HTTP
- Parametri percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Elenca gli eventi da uno spazio di Google Chat. Per ogni evento, il payload contiene la versione più recente della risorsa Chat. Ad esempio, se elenchi eventi relativi a nuovi membri dello spazio, il server restituisce Membership
risorse contenenti i dettagli più recenti dell'iscrizione. Se i nuovi membri sono stati rimossi durante il periodo richiesto, il payload dell'evento contiene una risorsa Membership
vuota.
Richiede l'autenticazione utente. Per elencare gli eventi, l'utente autenticato deve essere membro dello spazio.
Per un esempio, vedi Elencare gli eventi da uno spazio di Google Chat.
Richiesta HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
parent |
Obbligatorio. Nome della risorsa dello spazio di Google Chat in cui si sono verificati gli eventi. Formato: |
Parametri di query
Parametri | |
---|---|
page |
(Facoltativo) Il numero massimo di eventi dello spazio restituiti. Il servizio potrebbe restituire meno di questo valore. I valori negativi restituiscono un errore |
page |
Un token di pagina ricevuto da una precedente chiamata di eventi dello spazio elenco. Forniscilo per recuperare la pagina successiva. Quando esegui la paginazione, tutti gli altri parametri forniti per elencare gli eventi dello spazio devono corrispondere alla chiamata che ha fornito il token pagina. Il trasferimento di valori diversi agli altri parametri può portare a risultati imprevisti. |
filter |
Obbligatorio. Un filtro per query. Devi specificare almeno un tipo di evento ( Se vuoi, puoi anche filtrare per ora di inizio (
Per specificare un'ora di inizio o di fine, utilizza l'operatore uguale a Ad esempio, le seguenti query sono valide:
Le seguenti query non sono valide:
Le query non valide vengono rifiutate dal server con un errore |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Messaggio di risposta relativo alla creazione di una scheda per gli eventi dello spazio.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"spaceEvents": [
{
object ( |
Campi | |
---|---|
space |
I risultati vengono restituiti in ordine cronologico (primo evento meno recente). Nota: il campo |
next |
Token di continuazione utilizzato per recuperare più eventi. Se questo campo viene omesso, non verranno visualizzate altre pagine. |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
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
Per ulteriori informazioni, consulta la Guida all'autorizzazione.