Mendownload media dari lampiran file

Panduan ini menjelaskan cara menggunakan metode download pada resource Media dari Google Chat API untuk mendownload media (file) dari pesan di Google Chat.

Saat pengguna mengirim pesan ke aplikasi Anda, Google Chat akan mengirimkan peristiwa interaksi MESSAGE. Peristiwa interaksi yang diterima oleh aplikasi Anda mencakup isi permintaan, yang merupakan payload JSON yang merepresentasikan peristiwa interaksi, termasuk lampiran apa pun. Data dalam lampiran berbeda-beda, bergantung pada apakah lampiran tersebut adalah konten yang diupload (file lokal) atau file yang disimpan di Drive. Resource Media merepresentasikan file yang diupload ke Google Chat, seperti gambar, video, dan dokumen. Resource Attachment mewakili instance media—file—yang dilampirkan ke pesan. Resource Attachment mencakup metadata tentang lampiran, seperti tempat lampiran disimpan.

Prasyarat

Python

Mendownload dari lampiran file

Untuk mendownload media dari lampiran file, teruskan hal berikut dalam permintaan Anda:

Contoh berikut mendownload file yang dilampirkan ke pesan:

Python

  1. Di direktori kerja Anda, buat file bernama chat_media_and_attachment_download.py.

  2. Sertakan kode berikut di 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(
                'credentials.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. Dalam kode, ganti RESOURCE_NAME dengan attachmentDataRef.resourceName, yang dapat Anda ambil dengan salah satu cara berikut:

  4. Di direktori kerja Anda, buat dan jalankan contoh:

    python3 chat_media_and_attachment_download.py

Jika berhasil, metode ini akan menampilkan konten file sebagai byte.

Untuk mendownload isi file, pilih salah satu pendekatan berikut:

  • Sebaiknya gunakan class MediaIoBaseDownload di Python, yang berisi metode untuk mendownload file dalam beberapa bagian dan menyimpan konten ke aliran output.

  • Jika Anda harus membuat permintaan HTTP secara manual, panggil metode download dan tentukan bagian file yang ingin Anda download menggunakan rentang byte dengan header Range—misalnya: Range: bytes=500-999.