Questa guida spiega come utilizzare il metodo list
nella risorsa Message
di
l'API Google Chat per vedere un elenco impaginato e filtrabile di messaggi in uno spazio.
La
Message
risorsa
rappresenta un
testo
o
scheda
in Google Chat. Puoi
create
, get
, update
o delete
un messaggio nell'API Google Chat chiamando
metodi corrispondenti. Per ulteriori informazioni su SMS e messaggi di schede, vedi
Panoramica dei messaggi di Google Chat.
Prerequisiti
Python
- Un'azienda o un'impresa Google Workspace con accesso a Google Chat.
- Python 3.6 o versioni successive
- Lo strumento di gestione dei pacchetti pip
- Le librerie client di Google più recenti. Per installarle o aggiornarle,
esegui questo comando nell'interfaccia a riga di comando:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Configura l'ambiente:
- Creare un progetto Google Cloud.
- Configura la schermata per il consenso OAuth.
- Abilita e configura l'API Google Chat con un nome, l'icona e la descrizione dell'app Chat.
-
Creare credenziali con ID client OAuth per un'applicazione desktop. Per eseguire l'esempio in questo
guida, salva le credenziali come file JSON (
client_secrets.json
) nel tuo nella directory locale.
- Scegli un ambito di autorizzazione che supporti l'autenticazione degli utenti.
Elenco di messaggi
Per elencare i messaggi con autenticazione degli utenti, inserisci quanto segue nella tua richiesta:
- Specifica l'ambito dell'autorizzazione
chat.messages.readonly
ochat.messages
. - Chiama il
Metodo
list
ilMessage
risorsa.
Nell'esempio seguente sono elencati i messaggi di uno spazio di Chat che sono stati inviati dopo 16 marzo 2023:
Python
- Nella directory di lavoro, crea un file denominato
chat_messages_list.py
. Includi il seguente codice in
chat_messages_list.py
:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.messages.readonly"] def main(): ''' Authenticates with Chat API via user credentials, then lists messages in a space sent after March 16, 2023. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().messages().list( # The space for which to list messages. parent = 'spaces/SPACE', # An optional filter that returns messages # created after March 16, 2023. filter = 'createTime > "2023-03-16T00:00:00-00:00"' ).execute() # Prints the list of messages. print(result) if __name__ == '__main__': main()
Nel codice, sostituisci
SPACE
con il nome di uno spazio, che che puoi ottenere Metodospaces.list
nell'API Chat o dall'URL di uno spazio.Nella directory di lavoro, crea ed esegui l'esempio:
python3 chat_messages_list.py
L'API Chat restituisce un elenco di messaggi inviati nello spazio specificato
dopo il 16 marzo 2023. Se la richiesta non contiene messaggi,
La risposta dell'API Chat restituisce un oggetto vuoto. Se utilizzi un
Interfaccia REST/HTTP, la risposta contiene un oggetto JSON vuoto, {}
.
Argomenti correlati
- Formattare un messaggio.
- Eliminare un messaggio.
- Visualizzare i dettagli di un messaggio.
- Aggiorna un messaggio.
- Inviare un messaggio.