يمكنك بسهولة دمج وثيقتين أو أكثر من مستندات PDF في ملف PDF واحد برمجيًا على السحابة. يمكن أن يكون مفيدًا في مشاركة أو طباعة مستندات متعددة مجمعة في ملف واحد بدلاً من معالجة جميع الملفات واحدة تلو الأخرى. بصفتك مطور Python ، يمكنك دمج ملفين أو أكثر من ملفات PDF في ملف واحد في تطبيقات Python الخاصة بك. في هذه المقالة ، ستتعلم كيفية دمج ملفات PDF باستخدام واجهة برمجة تطبيقات REST في Python.
سيتم تناول الموضوعات التالية في هذه المقالة:
- PDF Merger REST API و Python SDK
- دمج ملفات PDF باستخدام REST API في Python
- دمج صفحات معينة من ملفات PDF متعددة باستخدام Python
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 على تطبيق Python الخاص بك باستخدام الأمر التالي في وحدة التحكم:
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 في Python
يمكنك دمج ملفين أو أكثر من ملفات 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 متعددة باستخدام Python
يمكنك بسهولة دمج ملفات PDF متعددة في ملف واحد برمجيًا باتباع الخطوات المذكورة أدناه:
- إنشاء مثيل لـ DocumentApi
- إنشاء مثيل من JoinItem
- قم بتوفير مسار ملف الإدخال لأول JoinItem في FileInfo
- قم بإنشاء مثيل آخر من JoinItem
- قم بتوفير مسار ملف الإدخال لـ JoinItem الثاني في FileInfo
- أضف المزيد من JoinItems لدمج أكثر من ملفين
- قم بإنشاء مثيل لـ JoinOptions
- أضف قائمة مفصولة بفواصل لعناصر الانضمام التي تم إنشاؤها
- قم بتعيين مسار ملف الإخراج
- قم بإنشاء مثيل لـ JoinRequest مع JoinOptions
- احصل على النتائج عن طريق استدعاء Join() طريقة DocumentAPI مع JoinRequest
يوضح مقتطف الشفرة التالي كيفية دمج ملفات PDF متعددة باستخدام واجهة برمجة تطبيقات REST في Python.
# تهيئة 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")
# ملف surce 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)
# إنشاء طلب ملف downlod
request = groupdocs_merger_cloud.DownloadFileRequest("Output/joined.pdf", my_storage)
# تحميل الملف
response = file_api.download_file(request)
# انقل الملف الذي تم تنزيله إلى دليل العمل الخاص بك
shutil.move(response, "C:\\Files\\")
دمج صفحات معينة من ملفات PDF متعددة باستخدام Python
يمكنك بسهولة دمج صفحات معينة من ملفات PDF متعددة في ملف واحد برمجيًا باتباع الخطوات المذكورة أدناه:
- إنشاء مثيل لـ DocumentApi
- إنشاء مثيل من JoinItem
- قم بتوفير مسار ملف الإدخال لأول JoinItem في FileInfo
- تحديد قائمة بأرقام الصفحات لدمجها
- قم بإنشاء مثيل آخر من JoinItem
- قم بتوفير مسار ملف الإدخال لـ JoinItem الثاني في FileInfo
- حدد رقم صفحة البداية ورقم صفحة النهاية
- حدد وضع نطاق الصفحات
- قم بإنشاء مثيل لـ JoinOptions
- أضف قائمة مفصولة بفواصل لعناصر الانضمام التي تم إنشاؤها
- قم بتعيين مسار ملف الإخراج
- قم بإنشاء مثيل لـ JoinRequest مع JoinOptions
- احصل على النتائج من خلال استدعاء Join() طريقة DocumentAPI مع JoinRequest
يوضح مقتطف الشفرة التالي كيفية دمج صفحات معينة من ملفات PDF متعددة باستخدام واجهة برمجة تطبيقات REST في Python.
# تهيئة 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]
# ملف surce 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 المجانية التالية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/merger/pdf
خاتمة
في هذه المقالة ، تعلمت كيفية دمج ملفات PDF متعددة على السحابة. لقد تعلمت أيضًا كيفية دمج صفحات معينة من مستندات PDF متعددة في ملف واحد باستخدام Python. علاوة على ذلك ، تعلمت كيفية تحميل ملفات PDF برمجيًا إلى السحابة ثم تنزيل الملف المدمج من السحابة. توفر واجهة برمجة تطبيقات REST لدمج ملفات PDF أيضًا حزم تطوير برامج .NET و Java و PHP و Ruby و Android و Node.js باعتبارها أعضاء عائلة دمج المستندات لواجهة برمجة التطبيقات السحابية. يمكنك معرفة المزيد حول GroupDocs.Merge Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، لا تتردد في الاتصال بنا على المنتدى.