اسناد انواع مختلف را با استفاده از REST API در پایتون ادغام کنید

ادغام اسناد مختلف از انواع مشابه یا متفاوت امکان جمع آوری داده ها یا اطلاعات پراکنده را در یک فایل واحد فراهم می کند. ما به راحتی می توانیم چندین سند از انواع فایل های مختلف را در یک فایل در فضای ابری ادغام کنیم. در این مقاله، نحوه ادغام اسناد از انواع فایل های مختلف را با استفاده از REST API در پایتون یاد خواهیم گرفت.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

File Merger REST API و Python SDK

برای ادغام چندین فایل، از Python SDK of GroupDocs.Merger Cloud API استفاده خواهیم کرد. این ما را قادر می‌سازد تا یک صفحه یا مجموعه‌ای از صفحات را از فرمت‌های سند پشتیبانی‌شده از Word، Excel، PowerPoint ترکیب، تقسیم، حذف و تنظیم مجدد کنیم، طراحی‌های Visio، PDF و HTML. لطفا با استفاده از دستور زیر در کنسول آن را نصب کنید:

pip install groupdocs-merger-cloud

لطفاً قبل از انجام مراحل ذکر شده [شناسه مشتری و راز خود را از داشبورد 9 دریافت کنید. هنگامی که شناسه و راز خود را دریافت کردید، کد را مطابق شکل زیر اضافه کنید:

# این مثال کد نحوه اضافه کردن شناسه مشتری و رمز را در کد نشان می دهد.
client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"

configuration = groupdocs_merger_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""

ادغام چندین نوع فایل با استفاده از REST API در پایتون

با دنبال کردن مراحل زیر می‌توانیم اسناد چند نوع فایل را به صورت برنامه‌نویسی در فضای ابری ترکیب کنیم:

  1. آپلود فایل ها را در ابر
  2. ادغام اسناد انواع مختلف فایل
  3. دانلود فایل ادغام شده

فایل ها را آپلود کنید

ابتدا فایل ها را با استفاده از نمونه کد زیر در فضای ابری آپلود می کنیم:

# این مثال کد نحوه آپلود فایل ها را در فضای ابری نشان می دهد.
# یک نمونه از API ها ایجاد کنید
file_api = groupdocs_merger_cloud.FileApi.from_config(configuration)

# فایل های نمونه را آپلود کنید
for filename in glob.iglob("C:\\Files\\Merger\\upload\\*.*", recursive=True):
    destFile = filename.replace("C:\\Files\\Merger\\upload", "", 1)           
    # درخواست فایل آپلود ایجاد کنید
    request = groupdocs_merger_cloud.UploadFileRequest(destFile, filename)
    # آپلود فایل
    file_api.upload_file(request)

در نتیجه، فایل‌های آپلود شده در بخش فایل‌ها داشبورد شما در فضای ابری در دسترس خواهند بود.

ادغام اسناد انواع مختلف فایل در پایتون

اکنون می‌توانیم به راحتی فایل‌های آپلود شده از انواع مختلف را با انجام مراحل زیر در یک فایل ادغام کنیم:

  • ابتدا یک نمونه از DocumentApi ایجاد کنید.
  • سپس، مسیر فایل ورودی را برای اولین JoinItem ارائه دهید.
  • سپس مسیر فایل ورودی را برای JoinItem دوم ارائه دهید.
  • در صورت تمایل، مراحل بالا را برای افزودن فایل های بیشتر تکرار کنید.
  • پس از آن JoinOptions را تعریف کرده و مسیر فایل خروجی را تنظیم کنید.
  • در نهایت، متد join() را فراخوانی کرده و سند ادغام شده را ذخیره کنید.

نمونه کد زیر نحوه ادغام انواع فایل های مختلف را با استفاده از REST API در پایتون نشان می دهد.

# این مثال کد نحوه ادغام اسناد انواع مختلف فایل در پایتون را نشان می دهد.
documentApi = groupdocs_merger_cloud.DocumentApi.from_keys(client_id, client_secret)

# فایل اول
item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("sample.pdf")

# فایل دوم
item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("sample.docx")

# گزینه های پیوستن
options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "joined.pdf"

# درخواست پیوستن را با JoinOptions ایجاد کنید
request = groupdocs_merger_cloud.JoinRequest(options)

# به فایل ها بپیوندید
result = documentApi.join(request)

فایل ادغام شده را دانلود کنید

در نهایت، نمونه کد بالا فایل PDF ادغام شده را در فضای ابری ذخیره می کند. با استفاده از نمونه کد زیر قابل دانلود است:

# این مثال کد نحوه دانلود یک فایل ادغام شده از ابر را نشان می دهد.
# مقداردهی اولیه API
file_api = groupdocs_merger_cloud.FileApi.from_config(configuration)

# درخواست فایل دانلود را ایجاد کنید
request = groupdocs_merger_cloud.DownloadFileRequest("joined.pdf", my_storage)

# دریافت فایل
response = file_api.download_file(request)

# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(response, "C:\\Files\\Merger\\")

نحوه ادغام PDF و Excel در PDF

ما می‌توانیم فایل‌های PDF و Excel را با انجام مراحلی که قبلا ذکر شد، در یک PDF ادغام کنیم. با این حال، ما فقط باید مسیرهای سند PDF و Excel را به عنوان اولین و دومین JoinItems ارائه کنیم. نمونه کد زیر نحوه ادغام یک سند PDF و برگه اکسل را در یک فایل PDF با استفاده از REST API در پایتون نشان می دهد.

# این مثال کد نحوه ادغام فایل ورد و اکسل را در PDF با استفاده از پایتون نشان می دهد.
documentApi = groupdocs_merger_cloud.DocumentApi.from_keys(client_id, client_secret)

# فایل اول
item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("sample.pdf")

# فایل دوم
item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("sample.xlsx")

# گزینه های پیوستن
options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "joined.pdf"

# درخواست پیوستن را با JoinOptions ایجاد کنید
request = groupdocs_merger_cloud.JoinRequest(options)

# به فایل ها بپیوندید
result = documentApi.join(request)

نحوه ادغام PDF و پاورپوینت در PDF

همچنین می‌توانیم اسناد PDF و ارائه‌های پاورپوینت را با دنبال کردن مراحل ذکر شده در پی‌دی‌اف ادغام کنیم. با این حال، ما فقط باید مسیرهای سند PDF و پاورپوینت را به عنوان اولین و دومین JoinItems ارائه کنیم. نمونه کد زیر نحوه ادغام یک سند PDF و یک ارائه پاورپوینت را در یک فایل PDF با استفاده از REST API در پایتون نشان می دهد.

# این مثال کد نحوه ادغام ورد و ارائه پاورپوینت را در PDF با استفاده از پایتون نشان می دهد.
documentApi = groupdocs_merger_cloud.DocumentApi.from_keys(client_id, client_secret)

# فایل اول
item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("sample.pdf")

# فایل دوم
item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("sample.pptx")

# گزینه های پیوستن
options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "joined.pdf"

# درخواست پیوستن را با JoinOptions ایجاد کنید
request = groupdocs_merger_cloud.JoinRequest(options)

# به فایل ها بپیوندید
result = documentApi.join(request)

صفحات خاصی از انواع فایل های مختلف را در پایتون ترکیب کنید

با دنبال کردن مراحل زیر می‌توانیم صفحات انتخاب شده از اسناد انواع مختلف را در یک فایل واحد ادغام کنیم:

  • ابتدا یک نمونه از DocumentApi ایجاد کنید.
  • سپس، مسیر فایل ورودی را برای اولین JoinItem ارائه دهید.
  • سپس، شماره صفحه خاصی را برای ادغام ارائه دهید.
  • سپس، مسیر فایل ورودی را برای دومین JoinItem ارائه دهید.
  • سپس، محدوده صفحات را برای ادغام با شماره صفحه شروع و شماره صفحه پایان تعریف کنید.
  • پس از آن JoinOptions را تعریف کرده و مسیر فایل خروجی را تنظیم کنید.
  • در نهایت، متد join() را فراخوانی کرده و سند ادغام شده را ذخیره کنید.

نمونه کد زیر نحوه ادغام صفحات خاصی از انواع فایل های مختلف را با استفاده از REST API در پایتون نشان می دهد.

# این مثال کد نحوه ادغام اسناد انواع مختلف فایل در پایتون را نشان می دهد.
documentApi = groupdocs_merger_cloud.DocumentApi.from_keys(client_id, client_secret)

# فایل اول
item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("sample.pdf")
# شماره صفحات برای ادغام از سند اول
item1.pages = [1, 2]

# فایل دوم
item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("sample.docx")
# محدوده صفحه برای ادغام از سند دوم
item2.start_page_number = 1
item2.end_page_number = 3
  
# گزینه های پیوستن
options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "joined.pdf"

# درخواست پیوستن را با JoinOptions ایجاد کنید
request = groupdocs_merger_cloud.JoinRequest(options)

# به فایل ها بپیوندید
result = documentApi.join(request)

آنلاین را امتحان کنید

لطفاً ابزار ادغام آنلاین رایگان زیر را که با استفاده از API بالا ایجاد شده است، امتحان کنید. https://products.groupdocs.app/merger/

نتیجه

در این مقاله یاد گرفتیم:

  • نحوه ادغام اسناد چند نوع فایل در پایتون
  • نحوه ترکیب صفحات خاص از اسناد انواع فایل های مختلف در پایتون.
  • بارگذاری چندین فایل در فضای ابری؛
  • نحوه دانلود PDF ادغام شده از ابر.

علاوه بر این، می‌توانید با استفاده از مستندات درباره GroupDocs.Merge Cloud API اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آن‌ها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با شماره fo با ما تماس بگیرید.

همچنین ببینید