Questa guida spiega come utilizzare il metodo upload
nella risorsa Media
dell'API Google Chat per caricare contenuti multimediali (un file) in Google Chat e quindi allegarli a un messaggio.
Quando l'utente invia un messaggio alla tua app, Google Chat invia un evento di interazione MESSAGE
.
L'evento di interazione ricevuto dalla tua app include un corpo della richiesta, che è il payload JSON che rappresenta l'evento di interazione, inclusi gli eventuali allegati. I dati dell'allegato sono diversi a seconda che si tratti di contenuti caricati (un file locale) o di un file archiviato su Drive. La risorsa Media
rappresenta un file caricato su Google Chat, come immagini, video e documenti.
La risorsa Attachment
rappresenta un'istanza di contenuti multimediali (un file) allegato a un messaggio. La risorsa Attachment
include i metadati relativi all'allegato, ad esempio dove è stato salvato.
Prerequisiti
Python
- Python 3.6 o versioni successive
- Lo strumento di gestione dei pacchetti pip
Le librerie client di Google più recenti per Python. Per installarli o aggiornarli, esegui questo comando nell'interfaccia a riga di comando:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Un progetto Google Cloud in cui l'API Google Chat è abilitata e configurata. Per i passaggi da seguire, consulta Creare un'app Google Chat.
Autorizzazione configurata per l'app di Chat. Il caricamento di contenuti multimediali come file allegato richiede l'autenticazione utente con l'ambito di autorizzazione
chat.messages.create
ochat.messages
.
Carica come file allegato
Per caricare i contenuti multimediali e allegarli a un messaggio, trasmetti quanto segue nella richiesta:
- Specifica l'ambito dell'autorizzazione
chat.messages.create
ochat.messages
. - Chiama i seguenti metodi di Google Chat:
- Per caricare il file, chiama il metodo
upload
nella risorsaMedia
.- Imposta
parent
sul nome dello spazio che ospita il file. - In
body
(il corpo della richiesta), impostafilename
sul nome del file allegato caricato. - Imposta
media_body
come istanza del file da caricare.
- Imposta
- Per creare un messaggio con il file caricato allegato, chiama il metodo
create
nella risorsaMessages
.- Imposta
attachment
come risposta dalla chiamata del metodoupload
nella risorsaMedia
. Il campoattachment
accetta un elenco.
- Imposta
- Per caricare il file, chiama il metodo
Nell'esempio seguente viene caricato un file immagine PNG e lo allega a un messaggio.
Python
- Nella directory di lavoro, crea un file denominato
chat_media_and_attachment_upload.py
. Includi il seguente codice in
chat_media_and_attachment_upload.py
:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build from googleapiclient.http import MediaFileUpload # 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.create"] def main(): ''' Authenticates with Chat API via user credentials, then uploads a file as media, creates a message, and attaches the file to the 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. service = build('chat', 'v1', credentials=creds) # Upload a file to Google Chat. media = MediaFileUpload('test_image.png', mimetype='image/png') # Create a message and attach the uploaded file to it. attachment_uploaded = service.media().upload( # The space to upload the attachment in. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. parent='spaces/SPACE', # The filename of the attachment, including the file extension. body={'filename': 'test_image.png'}, # Media resource of the attachment. media_body=media ).execute() print(attachment_uploaded) # Create a Chat message with attachment. result = service.spaces().messages().create( # The space to create the message in. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Must match the space name that the attachment is uploaded to. parent='spaces/SPACE', # The message to create. body={ 'text': 'Hello, world!', 'attachment': [attachment_uploaded] } ).execute() print(result) if __name__ == '__main__': main()
Nel codice, sostituisci
SPACE
con il nome dello spazio in cui caricare l'allegato, che puoi ottenere dal metodospaces.list
nell'API Chat o dall'URL di uno spazio.Nella directory di lavoro, crea ed esegui l'esempio:
python3 chat_media_and_attachment_upload.py
L'API Chat restituisce un corpo della risposta contenente attachmentDataRef
con i dettagli del file caricato.
Limiti e considerazioni
Mentre ti prepari a caricare i file e ad allegarli ai messaggi, tieni presente questi limiti e considerazioni:
- Puoi caricare file di dimensioni fino a 200 MB.
- Alcuni tipi di file non sono supportati e non possono essere caricati. Per maggiori dettagli, consulta Tipi di file bloccati in Google Chat.
Argomenti correlati
- Scaricare i contenuti multimediali come file allegato
- Recuperare i metadati relativi all'allegato di un messaggio