Files

from pathlib import Path from openemail import openemail page = openemail.files.list(kind='pdf', sort='largest')file = page['items'][0] Path(file['filename']).write_bytes(openemail.files.download(file['id'])) links = openemail.files.list_all_links(file['id'])print([(link['url'], link['downloads']) for link in links]) stats = openemail.files.stats()print(stats['totals']['files'], stats['uploaded']['bytes'])

मेलबॉक्स में रखी हर फ़ाइल, भेजे और पाए गए अटैचमेंट और उसमें अपलोड की गई फ़ाइलें, यानी ऐप का फ़ाइलें पेज। download पूरी फ़ाइल को bytes के रूप में लौटाता है, लिंक वे डाउनलोड लिंक हैं जिनके रूप में कोई फ़ाइल भेजी गई, साथ में यह कि हर लिंक कितनी बार लिया गया, और stats एनालिटिक्स टैब है।

list, list_all और iterate q, kind और sort लेते हैं, और साथ में direction (inbound, outbound या uploaded), address, यानी एक पते की फ़ाइलें जिसकी तुलना बिना केस का ध्यान रखे होती है, और since और until, एक datetime या ISO 8601 स्ट्रिंग। since अपने पल को शामिल करता है और until उससे ठीक पहले रुकता है।

from openemail import openemail uploads = openemail.files.list_all(direction='uploaded', since='2026-09-01') file = uploads[0] link = openemail.files.create_link(file['id'], domain='acme.com')print(link['url']) openemail.files.revoke_link(file['id'], link['id'])

create_link किसी फ़ाइल को ऐसे सार्वजनिक डाउनलोड लिंक पर प्रकाशित करता है जो बिना साइन-इन के खुलता है, और वह लिंक लौटाता है। लिंक domain के फ़ाइल होस्ट पर रहता है अगर उस डोमेन का कोई हो, जैसे files.acme.com, नहीं तो उस पते के फ़ाइल होस्ट पर जिसकी फ़ाइल है, नहीं तो API पते पर। किसी संदेश के साथ आई या गई फ़ाइल पहले सार्वजनिक स्टोरेज में कॉपी की जाती है, और प्रोग्राम या स्क्रिप्ट को 422 file_unshareable के साथ मना कर दिया जाता है।

from pathlib import Path from openemail import openemail upload = openemail.files.upload(    Path('price-list.pdf').read_bytes(),    filename='price-list.pdf',    content_type='application/pdf',) if upload['deletable']:    openemail.files.delete(upload['id']) result = openemail.files.delete_many([    'file_0c4e7a91d2b84f63a5e19b7d',    'file_6bb640f5b99e47deb758f1f5',])for kept in result['kept']:    print(kept['filename'], kept['reason'])

upload बाइट को जैसे हैं वैसे ही, 100 MB तक, filename नाम से रखता है, और वह फ़ाइल लौटाता है जिसकी id कोई send {'fileId': upload['id']} के रूप में जोड़ता है। content_type दें, वरना बाइट application/octet-stream के रूप में रखे जाते हैं। इसे कभी दोबारा नहीं आज़माया जाता, क्योंकि दूसरी कोशिश एक दूसरी कॉपी रख देती।

• files.list()पूरा रेफ़रेंस
• files.list_all()पूरा रेफ़रेंस
• files.iterate()पूरा रेफ़रेंस
• files.get()पूरा रेफ़रेंस
• files.download()पूरा रेफ़रेंस
• files.list_links()पूरा रेफ़रेंस
• files.list_all_links()पूरा रेफ़रेंस
• files.iterate_links()पूरा रेफ़रेंस
• files.create_link()पूरा रेफ़रेंस
• files.revoke_link()पूरा रेफ़रेंस
• files.stats()पूरा रेफ़रेंस
• files.upload()पूरा रेफ़रेंस
• files.delete()पूरा रेफ़रेंस
• files.delete_many()पूरा रेफ़रेंस