फ़ाइल अटैचमेंट से मीडिया डाउनलोड करें

इस गाइड में बताया गया है कि Google Chat में किसी मैसेज से मीडिया (फ़ाइल) डाउनलोड करने के लिए, Google Chat API के Media संसाधन पर download तरीके का इस्तेमाल कैसे किया जा सकता है.

जब उपयोगकर्ता आपके ऐप्लिकेशन पर मैसेज भेजता है, तो Google Chat MESSAGE इंटरैक्शन को भेजता है. आपके ऐप्लिकेशन को मिले इंटरैक्शन इवेंट में, अनुरोध का मुख्य हिस्सा शामिल होता है. यह JSON पेलोड होता है, जो इंटरैक्शन इवेंट के बारे में जानकारी देता है. इसमें अटैचमेंट भी शामिल होता है. अटैचमेंट में मौजूद डेटा इस आधार पर अलग होता है कि अटैचमेंट को अपलोड किया गया कॉन्टेंट (कोई लोकल फ़ाइल) है या वह Drive पर सेव की गई कोई फ़ाइल है. Media रिसॉर्स, Google Chat पर अपलोड की गई फ़ाइल के बारे में बताता है, जैसे कि इमेज, वीडियो, और दस्तावेज़. Attachment संसाधन, मीडिया के एक इंस्टेंस को दिखाता है. यह फ़ाइल किसी मैसेज से अटैच की जाती है. Attachment संसाधन में अटैचमेंट के बारे में मेटाडेटा शामिल होता है, जैसे कि उसे कहां सेव किया जाता है.

ज़रूरी शर्तें

Python

  • Python 3.6 या इससे नया वर्शन
  • pip पैकेज मैनेजमेंट टूल
  • Python के लिए, Google की नई क्लाइंट लाइब्रेरी. इन्हें इंस्टॉल या अपडेट करने के लिए, अपने कमांड-लाइन इंटरफ़ेस में इस कमांड को चलाएं:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
    
  • ऐसा Google Cloud प्रोजेक्ट जिसमें Google Chat API चालू हो और उसे कॉन्फ़िगर किया गया हो. इसका तरीका जानने के लिए, Google Chat ऐप्लिकेशन बनाना देखें.
  • Chat ऐप्लिकेशन के लिए अनुमति देने की सेटिंग कॉन्फ़िगर की गई. मीडिया डाउनलोड करने पर, ये दोनों काम किए जा सकते हैं:

किसी फ़ाइल अटैचमेंट से डाउनलोड करें

किसी फ़ाइल अटैचमेंट से मीडिया डाउनलोड करने के लिए, अपने अनुरोध में यह जानकारी दें:

यहां दिए गए उदाहरण में, मैसेज के साथ अटैच की गई फ़ाइल डाउनलोड की गई है:

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 क्लास का इस्तेमाल करें. इसमें फ़ाइल को सेक्शन में डाउनलोड करने और कॉन्टेंट को आउटपुट स्ट्रीम में सेव करने के तरीके शामिल होते हैं.

  • अगर आपको मैन्युअल तरीके से एचटीटीपी अनुरोध करना है, तो download तरीके को कॉल करें. इसके बाद, Range हेडर के साथ बाइट रेंज का इस्तेमाल करके, फ़ाइल के उस हिस्से की जानकारी दें जिसे आपको डाउनलोड करना है. उदाहरण के लिए: Range: bytes=500-999.