Scaricare contenuti multimediali da un file allegato

Questa guida spiega come utilizzare il metodo download nella risorsa Media dell'API Google Chat per scaricare contenuti multimediali (un file) da un messaggio in Google Chat.

Quando l'utente invia un messaggio alla tua app, Google Chat invia un MESSAGE evento di interazione. L'evento di interazione ricevuto dalla tua app include un corpo della richiesta, ovvero il payload JSON che rappresenta l'evento di interazione, inclusi eventuali allegati. I dati nell'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 dell'allegato, ad esempio la posizione in cui è salvato.

Prerequisiti

Python

Scaricare da un file allegato

Per scaricare contenuti multimediali da un allegato file, nella richiesta specifica quanto segue:

L'esempio seguente scarica un file allegato a un messaggio:

Python

  1. Nella directory di lavoro, crea un file denominato chat_media_and_attachment_download.py.
  2. Includi il seguente codice in chat_media_and_attachment_download.py:

    import io
    
    from google_auth_oauthlib.flow import InstalledAppFlow
    from googleapiclient.discovery import build
    from googleapiclient.http import MediaIoBaseDownload
    
    # 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"]
    
    def main():
        '''
        Authenticates with Chat API via user credentials,
        then downloads a file attached to 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)
    
        # Download media resource.
        request = chat.media().download_media(
            resourceName=RESOURCE_NAME,
        )
        file = io.BytesIO()
        downloader = MediaIoBaseDownload(file, request)
    
        done = False
        while done is False:
            status, done = downloader.next_chunk()
            if status.total_size:
                print(f'Total size: {status.total_size}')
            print(f'Download {int(status.progress() * 100)}')
    
    if __name__ == '__main__':
        main()
    
  3. Nel codice, sostituisci RESOURCE_NAME con attachmentDataRef.resourceName, che puoi recuperare in uno dei seguenti modi:

  4. Nella directory di lavoro, compila ed esegui l'esempio:

    python3 chat_media_and_attachment_download.py

In caso di esito positivo, questo metodo restituisce i contenuti del file sotto forma di byte.

Per scaricare i contenuti del file, scegli uno dei seguenti approcci:

  • Ti consigliamo di utilizzare la classe MediaIoBaseDownload in Python, che contiene metodi per scaricare il file in sezioni e salvare i contenuti in uno stream di output.

  • Se devi effettuare la richiesta HTTP manualmente, chiama il metodo download e specifica la parte del file che vuoi scaricare utilizzando un intervallo di byte con l'intestazione Range, ad esempio: Range: bytes=500-999.