Method: spaces.messagePins.list

Elenca i messaggi fissati in uno spazio. Gli utenti possono fissare i messaggi importanti negli spazi per accedervi facilmente. Per saperne di più, consulta Fissare o annullare il fissaggio di una conversazione in Google Chat.

Richiede l'autenticazione dell'utente con uno dei seguenti ambiti di autorizzazione:

  • https://www.googleapis.com/auth/chat.spaces.pins.readonly
  • https://www.googleapis.com/auth/chat.spaces.pins
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.spaces

Richiesta HTTP

GET https://chat.googleapis.com/v1/{parent=spaces/*}/messagePins

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Lo spazio principale che possiede la raccolta di elementi fissati. Formato: spaces/{space}

Parametri di query

Parametri
pageSize

integer

Facoltativo. Il numero massimo di messaggi fissati restituiti. Il servizio potrebbe restituire un numero inferiore di messaggi rispetto a questo valore. Il valore massimo è 100. Se utilizzi un valore superiore a 100, questo viene modificato automaticamente in 100. Se non è specificato, verranno restituiti al massimo 100 messaggi fissati. I valori negativi restituiscono un errore INVALID_ARGUMENT.
pageToken

string

Facoltativo. Un token di pagina ricevuto da una precedente chiamata di messaggi fissati dell'elenco. Fornisci questo parametro per recuperare la pagina successiva.

Quando esegui la paginazione, tutti gli altri parametri forniti devono corrispondere alla chiamata che ha fornito il token di pagina. Il passaggio di valori diversi agli altri parametri potrebbe portare a risultati imprevisti.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per l'elenco dei messaggi fissati.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "messagePins": [
    {
      object (MessagePin)
    }
  ],
  "nextPageToken": string
}
Campi
messagePins[]

object (MessagePin)

I messaggi fissati dallo spazio specificato.
nextPageToken

string

Puoi inviare un token come pageToken per recuperare la pagina successiva dei risultati. Se è vuoto, non ci sono pagine successive.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.spaces.pins
  • https://www.googleapis.com/auth/chat.spaces.pins.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly

Per saperne di più, consulta la guida all'autorizzazione.