Questa guida spiega come utilizzare il metodo get
nella risorsa Message
di
l'API Google Chat per restituire i dettagli di un messaggio di testo o di una scheda.
Nell'API Chat, un messaggio di Chat è rappresentato dalla
Message
risorsa.
Anche se gli utenti di Chat possono inviare
solo messaggi contenenti testo,
Le app di chat possono utilizzare molte altre funzionalità di messaggistica, tra cui:
Mostrare interfacce utente statiche o interattive, raccogliendo informazioni da
utenti e distribuire i messaggi in privato. Per scoprire di più sui messaggi
disponibili per l'API Chat, consulta le
Panoramica dei messaggi di Google Chat.
Prerequisiti
Python
- Un'azienda o un'impresa Google Workspace con accesso a Google Chat.
- 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.
- Installa il Python Libreria client delle API di Google.
- Crea credenziali di accesso in base a come vuoi autenticarti nell'API Google Chat
richiesta:
- Per autenticarti come utente di Chat,
crea ID client OAuth
credenziali e salvale come file JSON denominato
client_secrets.json
alla tua directory locale. - Per autenticarti come app Chat,
crea account di servizio
credenziali e salvale come file JSON denominato
credentials.json
.
- Per autenticarti come utente di Chat,
crea ID client OAuth
credenziali e salvale come file JSON denominato
- Scegli un ambito di autorizzazione a seconda che tu voglia eseguire l'autenticazione come utente o come Chat.
Ricevere un messaggio con l'autenticazione utente
Per ottenere dettagli su un messaggio con autenticazione degli utenti, inserisci quanto segue nella tua richiesta:
- Specifica l'ambito dell'autorizzazione
chat.messages.readonly
ochat.messages
. - Chiama il
Metodo
get
ilMessage
risorsa. - Imposta
name
sul nome della risorsa del messaggio da recuperare.
L'esempio seguente restituisce un messaggio con autenticazione utente:
Python
- Nella directory di lavoro, crea un file denominato
chat_message_get_user.py
. Includi il seguente codice in
chat_message_get_user.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 gets a message. ''' # 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().get( # The message to get. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MESSAGE with a message name. # Obtain the message name from the response body returned # after creating a message asynchronously with Chat REST API. name = 'spaces/SPACE/messages/MESSAGE' ).execute() # Prints details about the message. print(result) if __name__ == '__main__': main()
Nel codice, sostituisci quanto segue:
SPACE
: il nome di uno spazio, che puoi ottenere il Metodospaces.list
nell'API Chat o dall'URL di uno spazio.MESSAGE
: il nome di un messaggio, che puoi ottenere dal corpo della risposta restituito dopo la creazione del messaggio in modo asincrono. con l'API Chat o con nome personalizzato e assegnato al messaggio al momento della creazione.
Nella directory di lavoro, crea ed esegui l'esempio:
python3 chat_message_get_user.py
L'API Chat restituisce un'istanza
Message
che descrive in dettaglio il messaggio specificato.
Ricevere un messaggio con l'autenticazione delle app
Per ottenere dettagli su un messaggio con autenticazione delle app, inserisci quanto segue nella tua richiesta:
- Specifica l'ambito dell'autorizzazione
chat.bot
. - Chiama il
Metodo
get
ilMessage
risorsa. - Imposta
name
sul nome della risorsa del messaggio da recuperare.
L'esempio seguente restituisce un messaggio con autenticazione app:
Python
- Nella directory di lavoro, crea un file denominato
chat_get_message_app.py
. Includi il seguente codice in
chat_get_message_app.py
:from google.oauth2 import service_account from apiclient.discovery import build # Specify required scopes. SCOPES = ['https://www.googleapis.com/auth/chat.bot'] # Specify service account details. CREDENTIALS = ( service_account.Credentials.from_service_account_file('credentials.json') .with_scopes(SCOPES) ) # Build the URI and authenticate with the service account. chat = build('chat', 'v1', credentials=CREDENTIALS) # Get a Chat message. result = chat.spaces().messages().get( # The message to get. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MESSAGE with a message name. # Obtain the message name from the response body returned # after creating a message asynchronously with Chat REST API. name='spaces/SPACE/messages/MESSAGE' ).execute() # Print Chat API's response in your command line interface. print(result)
Nel codice, sostituisci quanto segue:
SPACE
: ilname
dello spazio in cui che viene pubblicato, reperibile nella Metodospaces.list
nell'API Chat o dall'URL di uno spazio.MESSAGE
: il nome del messaggio, che puoi ottenere dal corpo della risposta restituito dopo la creazione del messaggio in modo asincrono. con l'API Chat o con nome personalizzato e assegnato al messaggio al momento della creazione.
Nella directory di lavoro, crea ed esegui l'esempio:
python3 chat_get_message_app.py
L'API Chat restituisce un'istanza
Message
che descrive in dettaglio il messaggio specificato.
Argomenti correlati
- Formattare un messaggio.
- Eliminare un messaggio.
- Elenca i messaggi in uno spazio.
- Aggiorna un messaggio.
- Inviare un messaggio.