첨부파일에서 미디어 다운로드

이 가이드에서는 다음의 Media 리소스에서 download 메서드를 사용하는 방법을 설명합니다. Google Chat API를 사용하여 Google Chat의 메시지에서 미디어 (파일) 다운로드

사용자가 앱에 메시지를 보내면 Google Chat에서 MESSAGE 상호작용 이벤트. 앱에서 수신한 상호작용 이벤트에는 요청 본문인 첨부파일을 포함하여 상호작용 이벤트를 나타내는 JSON 페이로드입니다. 이 첨부파일의 데이터는 첨부파일이 올바른지 여부에 따라 Drive에 저장된 파일 (로컬 파일)일 수 있습니다. 이 Media 리소스 이미지, 동영상, 문서 등 Google Chat에 업로드된 파일을 나타냅니다. 이 Attachment 리소스 메시지에 첨부된 미디어(파일)의 인스턴스를 나타냅니다. Attachment 리소스에는 첨부파일에 대한 메타데이터가 포함됩니다(예: .

기본 요건

Python

첨부파일에서 다운로드

첨부파일에서 미디어를 다운로드하려면 다음을 요청:

다음은 메일에 첨부된 파일을 다운로드하는 예입니다.

Python

  1. 작업 디렉터리에서 chat_media_and_attachment_download.py
  2. 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. 코드에서 RESOURCE_NAME를 다음으로 바꿉니다. attachmentDataRef.resourceName: 방법은 다음과 같습니다.

  4. 작업 디렉터리에서 샘플을 빌드하고 실행합니다.

    python3 chat_media_and_attachment_download.py
    

성공하는 경우 이 메서드는 파일 콘텐츠를 바이트로 반환합니다.

파일 콘텐츠를 다운로드하려면 다음 방법 중 하나를 선택합니다.

  • 이때 Python의 MediaIoBaseDownload 클래스: 파일을 섹션으로 가져오고 콘텐츠를 출력 스트림에 저장합니다.

  • 수동으로 HTTP 요청을 해야 하는 경우 download 메서드를 호출하고 다운로드하려는 파일의 일부분을 바이트 범위Range 헤더로 바꿉니다(예: Range: bytes=500-999).

를 통해 개인정보처리방침을 정의할 수 있습니다.