- Richiesta HTTP
- Parametri percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Elenca i messaggi presenti in uno spazio di cui il chiamante è membro, inclusi i messaggi provenienti da spazi e membri bloccati. Se elenchi i messaggi provenienti da uno spazio senza messaggi, la risposta è un oggetto vuoto. Quando utilizzi un'interfaccia REST/HTTP, la risposta contiene un oggetto JSON vuoto, {}
. Per un esempio, vedi Elencare i messaggi. Richiede l'autenticazione dell'utente.
Richiesta HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/messages
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
parent |
Obbligatorio. Il nome della risorsa dello spazio da cui elencare i messaggi. Formato: |
Parametri di query
Parametri | |
---|---|
pageSize |
Il numero massimo di messaggi restituiti. Il servizio potrebbe restituire meno messaggi di questo valore. Se non specificato, vengono restituiti al massimo 25. Il valore massimo è 1000. Se utilizzi un valore superiore a 1000, il valore viene modificato automaticamente in 1000. I valori negativi restituiscono un errore |
pageToken |
Facoltativo, se riprendi da una query precedente. Un token di pagina ricevuto da una precedente chiamata di messaggi dell'elenco. Fornisci questo parametro per recuperare la pagina successiva. Durante l'impaginazione, tutti gli altri parametri forniti devono corrispondere alla chiamata che ha fornito il token della pagina. Il trasferimento di valori diversi agli altri parametri può portare a risultati imprevisti. |
filter |
Un filtro di query. Puoi filtrare i messaggi per data ( Per filtrare i messaggi in base alla data di creazione, specifica Per filtrare in base al thread, specifica il valore Per filtrare sia in base al thread che alla data, utilizza l'operatore Ad esempio, le seguenti query sono valide:
Le query non valide vengono rifiutate dal server con un errore |
orderBy |
Facoltativo, se riprendi da una query precedente. Ordinamento dell'elenco dei messaggi. Specifica un valore da ordinare tramite un'operazione di ordinamento. I valori validi per le operazioni di ordinamento sono i seguenti:
L'ordine predefinito è |
showDeleted |
Se includere i messaggi eliminati. I messaggi eliminati includono l'ora e i metadati relativi alla loro eliminazione, ma i contenuti dei messaggi non sono disponibili. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Messaggio di risposta relativo ai messaggi dell'elenco.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"messages": [
{
object ( |
Campi | |
---|---|
messages[] |
Elenco dei messaggi. |
nextPageToken |
Puoi inviare un token come |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
Per ulteriori informazioni, consulta la Guida all'autorizzazione.