شما به راحتی می توانید دو یا چند سند PDF را در یک فایل PDF به صورت برنامه نویسی در فضای ابری ترکیب کنید. این می تواند در به اشتراک گذاری یا چاپ چندین سند ترکیب شده در یک فایل واحد به جای پردازش همه فایل ها یک به یک مفید باشد. به عنوان یک توسعه دهنده پایتون، می توانید دو یا چند فایل PDF را در یک فایل واحد در برنامه های پایتون خود ادغام کنید. در این مقاله نحوه ادغام فایل های PDF با استفاده از REST API در پایتون را خواهید آموخت.
موضوعات زیر در این مقاله پوشش داده خواهد شد:
- PDF Merger REST API و Python SDK
- ادغام فایل های PDF با استفاده از REST API در پایتون
- ادغام صفحات خاص از چندین فایل PDF با استفاده از پایتون
PDF Merger REST API و Python SDK
برای ادغام دو یا چند فایل PDF، من از Python SDK of GroupDocs.Merger Cloud API استفاده خواهم کرد. این به شما امکان می دهد دو یا چند سند را در یک سند واحد ترکیب کنید یا یک سند منبع را به چندین سند حاصل تقسیم کنید. همچنین به شما امکان می دهد جهت صفحه را به صورت عمودی یا افقی برای کل یا محدوده ترجیحی صفحات تغییر دهید، حذف کنید، مبادله کنید، بچرخانید یا تغییر دهید. SDK از ادغام و تقسیم تمام فرمت های سند محبوب مانند Word، Excel، PowerPoint، Visio، OneNote، PDF، HTML و غیره پشتیبانی می کند.
می توانید GroupDocs.Merger Cloud را با استفاده از دستور زیر در کنسول در برنامه پایتون خود نصب کنید:
pip install groupdocs_merger_cloud
لطفاً قبل از انجام مراحل ذکر شده، شناسه مشتری و راز خود را از داشبورد دریافت کنید. هنگامی که شناسه و راز خود را دریافت کردید، کد را مطابق شکل زیر اضافه کنید:
client_id = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5"
client_secret = "479db2b01dcb93a3d4d20efb16dea971"
configuration = groupdocs_merger_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""
ادغام فایل های PDF با استفاده از REST API در پایتون
با دنبال کردن مراحل ساده ذکر شده در زیر می توانید دو یا چند فایل PDF را به صورت برنامه نویسی در فضای ابری ترکیب کنید:
فایل های PDF را آپلود کنید
ابتدا فایل های PDF را با استفاده از مثال کد زیر در فضای ابری آپلود کنید:
# نمونه ای از API ایجاد کنید
file_api = groupdocs_merger_cloud.FileApi.from_config(configuration)
storage_api = groupdocs_merger_cloud.StorageApi.from_config(configuration)
# فایل های نمونه را آپلود کنید
for filename in glob.iglob("C:\\Files\\upload\\*.pdf", recursive=True):
destFile = filename.replace("C:\\Files\\upload", "", 1)
# بررسی کنید که آیا فایل از قبل وجود دارد
fileExistsResponse = storage_api.object_exists(groupdocs_merger_cloud.ObjectExistsRequest(destFile))
if not fileExistsResponse.exists:
# ایجاد درخواست آپلود فایل
request = groupdocs_merger_cloud.UploadFileRequest(destFile, filename)
# آپلود فایل
file_api.upload_file(request)
در نتیجه، فایل‌های PDF آپلود شده در بخش فایل‌ها داشبورد شما در فضای ابری در دسترس خواهند بود.
ادغام چندین فایل PDF با استفاده از پایتون
با دنبال کردن مراحل ذکر شده در زیر می توانید به راحتی چندین فایل PDF را به صورت برنامه نویسی در یک فایل ادغام کنید:
- یک نمونه از DocumentApi ایجاد کنید
- یک نمونه از JoinItem ایجاد کنید
- مسیر فایل ورودی را برای اولین JoinItem در FileInfo ارائه دهید
- نمونه دیگری از JoinItem ایجاد کنید
- مسیر فایل ورودی را برای JoinItem دوم در FileInfo ارائه دهید
- JoinItems بیشتری برای ادغام بیش از دو فایل اضافه کنید
- یک نمونه از JoinOptions ایجاد کنید
- فهرستی از موارد پیوسته ایجاد شده جدا شده با کاما اضافه کنید
- مسیر فایل خروجی را تنظیم کنید
- یک نمونه از JoinRequest با JoinOptions ایجاد کنید
- با فراخوانی متد join() از DocumentAPI با JoinRequest به نتیجه برسید.
قطعه کد زیر نحوه ادغام چندین فایل PDF را با استفاده از REST API در پایتون نشان می دهد.
# مقداردهی اولیه api
documentApi = groupdocs_merger_cloud.DocumentApi.from_config(configuration)
# فایل سورس 1
item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("ten-pages_1.pdf")
# فایل سورس 2
item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("ten-pages_2.pdf")
# گزینه های پیوستن را تعریف کنید
options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "Output/joined.pdf"
# ایجاد درخواست پیوستن
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("Output/joined.pdf", my_storage)
# دریافت فایل
response = file_api.download_file(request)
# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(response, "C:\\Files\\")
ادغام صفحات خاص از چندین فایل PDF با استفاده از پایتون
با دنبال کردن مراحل ذکر شده در زیر می توانید به راحتی صفحات خاصی را از چندین فایل PDF در یک فایل واحد به صورت برنامه نویسی ترکیب کنید:
- یک نمونه از DocumentApi ایجاد کنید
- یک نمونه از JoinItem ایجاد کنید
- مسیر فایل ورودی را برای اولین JoinItem در FileInfo ارائه دهید
- فهرستی از شماره صفحات را برای ادغام تعریف کنید
- نمونه دیگری از JoinItem ایجاد کنید
- مسیر فایل ورودی را برای JoinItem دوم در FileInfo ارائه دهید
- شماره صفحه شروع و شماره صفحه پایان را تعریف کنید
- حالت محدوده صفحه را تعریف کنید
- یک نمونه از JoinOptions ایجاد کنید
- فهرستی از موارد پیوسته ایجاد شده جدا شده با کاما اضافه کنید
- مسیر فایل خروجی را تنظیم کنید
- یک نمونه از JoinRequest با JoinOptions ایجاد کنید
- با فراخوانی متد join() DocumentAPI با JoinRequest به نتیجه برسید.
قطعه کد زیر نحوه ادغام صفحات خاص از چندین فایل PDF را با استفاده از REST API در پایتون نشان می دهد.
# مقداردهی اولیه api
documentApi = groupdocs_merger_cloud.DocumentApi.from_config(configuration)
# فایل منبع 1
item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("Output/joined.pdf")
# شماره صفحات صفحات خاص برای ادغام
item1.pages = [1,2]
# فایل سورس 2
item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("ten-pages.pdf")
# شماره صفحه شروع
item2.start_page_number = 2
# شماره صفحه پایانی
item2.end_page_number = 4
# حالت محدوده صفحه
item2.range_mode = "OddPages"
# گزینه های پیوستن را تعریف کنید
options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "Output/joined-pages.pdf"
# ایجاد درخواست پیوستن
request = groupdocs_merger_cloud.JoinRequest(options)
# ادغام صفحات
result = documentApi.join(request)
آنلاین را امتحان کنید
لطفاً ابزار آنلاین رایگان ادغام PDF زیر را که با استفاده از API بالا توسعه داده شده است، امتحان کنید. https://products.groupdocs.app/merger/pdf
نتیجه
در این مقاله، نحوه ادغام چندین فایل PDF را در فضای ابری یاد گرفتید. شما همچنین یاد گرفته اید که چگونه صفحات خاصی از چندین سند PDF را با استفاده از پایتون در یک فایل ترکیب کنید. علاوه بر این، شما یاد گرفته‌اید که چگونه فایل‌های PDF را به صورت برنامه‌نویسی در فضای ابری آپلود کنید و سپس فایل ادغام‌شده را از Cloud دانلود کنید. API ادغام PDF REST همچنین SDK های .NET، جاوا، PHP، Ruby، Android و Node.js را به عنوان [اعضای خانواده ادغام اسناد12 برای Cloud API ارائه می دهد. می‌توانید با استفاده از مستندات درباره GroupDocs.Merge Cloud API اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه می دهیم که به شما امکان می دهد API های ما را مستقیماً از طریق مرورگر تجسم کنید و با آنها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در [تالار] تماس حاصل فرمایید15.