- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Elenca i messaggi in uno spazio di cui il chiamante è membro, inclusi i messaggi provenienti da spazi e membri bloccati. Per un esempio, vedi Elenca messaggi. Richiede l'autenticazione degli utenti.
Richiesta HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/messages
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
parent |
Obbligatoria. Il nome della risorsa dello spazio da cui elencare i messaggi. Formato: |
Parametri di ricerca
Parametri | |
---|---|
pageSize |
Il numero massimo di messaggi restituiti. Il servizio potrebbe restituire meno messaggi di questo valore. Se non specificati, vengono restituiti al massimo 25 valori. Il valore massimo è 1000. Se utilizzi un valore superiore a 1000, questo viene automaticamente modificato in 1000. I valori negativi restituiscono un errore |
pageToken |
Facoltativo, in caso di ripresa da una query precedente. Un token di pagina ricevuto da una precedente chiamata di messaggi dell'elenco. Specifica 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 potrebbe 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 Per filtrare sia per thread sia per data, utilizza l'operatore Ad esempio, le seguenti query sono valide:
Le query non valide vengono rifiutate dal server con un errore |
orderBy |
Facoltativo, in caso di ripresa da una query precedente. Come viene ordinato l'elenco dei messaggi. Specifica un valore per ordinare tramite un'operazione di ordinamento. I valori validi per le operazioni di ordinamento sono i seguenti:
L'ordinamento predefinito è |
showDeleted |
Se includere i messaggi eliminati. I messaggi eliminati includono data e ora dell'eliminazione e metadati relativi alla loro eliminazione, ma i contenuti non sono disponibili. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Messaggio di risposta per l'elenco dei messaggi.
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.