دمج ملفات PDF في بايثون

تُعرض عمليات تقسيم ودمج PDF عادةً في برامج مدفوعة الأجر ولا توفر معظم برامج عرض PDF المجانية هذه الإمكانيات. أيضًا، في حالة احتياجك إلى دمج مستندات PDF معينة معًا، فأنت بحاجة أولاً إلى تثبيت وتكوين وشراء اشتراك الترخيص الكامل. قد يكون لديك متطلب لدمج ملفات PDF فقط ولكن سيتعين عليك دفع سعر الترخيص الكامل. وبصرف النظر عن هذا، قد تتعثر في سيناريو تحتاج فيه إلى دمج ملفات PDF ولكن البرنامج غير متاح على منصة معينة. لذلك، من أجل التخفيف من حدة جميع هذه السيناريوهات، نوصي باستخدام واجهة برمجة تطبيقات Aspose.PDF Cloud لدمج ملفات PDF عبر الإنترنت. لا يلزم تنزيل أو تثبيت البرنامج وإجراء جميع العمليات في السحابة.

واجهة برمجة تطبيقات معالجة PDF في Python

Aspose.PDF Cloud SDK for Python عبارة عن غلاف حول واجهة برمجة تطبيقات Aspose.PDF Cloud التي توفر جميع القوى والإمكانات اللازمة لمعالجة ملفات PDF لمطوري Python. وبالمثل، توفر SDK أيضًا ميزة دمج/دمج ملفات PDF متعددة في مستند إخراج واحد ويمكن إنجاز كل هذا باستخدام بضعة أسطر من التعليمات البرمجية.

تثبيت

قبل أن ننتقل إلى الخطوة التالية، فإن الخطوة الأولى هي تثبيت SDK إما من مستودع PIP أو GitHub. في هذه المقالة، سنناقش خطوات التثبيت من PIP. ما عليك سوى تنفيذ الأمر التالي على موجه الأوامر/المحطة الطرفية لتثبيت أحدث إصدار من SDK على النظام.

pip install asposepdfcloud

التثبيت في Pycharm

PyCharm هي بيئة تطوير متكاملة شائعة لتطوير Python. لذا، لاستخدام SDK مباشرةً في بيئة التطوير المتكاملة Python، يُرجى اتباع الخطوات الموضحة أدناه.

انقر فوق عنصر القائمة “التفضيلات” ضمن قائمة PyCharm.

عنصر قائمة التفضيلات

من الشجرة اليسرى، حدد Python Interpreter ضمن قسم المشروع.

خيار مترجم بايثون

الآن انقر فوق علامة + (زائد) في القسم الأيمن وأدخل asposepdfcloud في حقل البحث فوق مربع حوار الحزم المتوفرة.

حوار الحزم المتاحة

الآن انقر فوق الزر “تثبيت الحزمة”. بمجرد تثبيت مجموعة أدوات التطوير البرمجية، ستظهر رسالة النجاح.

دمج ملفات PDF في بايثون

يستخدم Aspose.PDF Cloud خدمات التخزين السحابية لتخزين المستندات. لذلك، لضمان سلامة البيانات وخصوصيتها، لا يحق إلا للأشخاص المصرح لهم الوصول إلى واجهات برمجة التطبيقات. لذا فإن الخطوة الأولى هي إنشاء حساب من خلال زيارة لوحة تحكم Aspose.Cloud. إذا كان لديك حساب GitHub أو Google، فما عليك سوى التسجيل. بخلاف ذلك، انقر فوق الزر إنشاء حساب جديد وقم بتقديم المعلومات المطلوبة. الآن قم بتسجيل الدخول إلى لوحة التحكم باستخدام بيانات الاعتماد وقم بتوسيع قسم التطبيقات من لوحة التحكم وانتقل لأسفل نحو قسم بيانات اعتماد العميل لرؤية تفاصيل معرف العميل والسر الخاص بالعميل.

فيما يلي الخطوات اللازمة لدمج مستندات PDF.

  • أولاً، قم بإنشاء كائن ApiClient أثناء تمرير ClientSecret وClientID كوسائط.
  • ثانيًا، قم بإنشاء مثيل PdfApi أثناء تمرير كائن ApiClient كحجة.
  • ثم قم بإنشاء كائن Opts حيث نقوم بتعريف ملف PDF المستهدف الذي سيتم إلحاقه، وصفحة البداية والنهاية لملف PDF.
  • أخيرًا، قم باستدعاء طريقة postappenddocument(…) لإجراء عمليات دمج ملفات PDF.
# احصل على ClientId وClientSecret من https://dashboard.aspose.cloud (التسجيل المجاني مطلوب).

#initialize PdfApi client instance using ClientID and ClientSecret
pdf_api_client = asposepdfcloud.api_client.ApiClient("d87269aade6a46cdc295b711e26809af", "a41d01ef-dfd5-4e02-ad29-bd85fe41e3e4")

# إنشاء مثيل PdfApi أثناء تمرير PdfApiClient كحجة
pdf_api = PdfApi(pdf_api_client)

# وثيقة PDF المصدر
file_name = 'PdfWithAnnotations.pdf'

# ملف PDF الذي يجب إضافة صفحاته
append_file_name = 'PdfWithTable.pdf'

# إنشاء خيارات تحديد مثيل الترابط في ملف PDF
# صفحة البداية والنهاية لملف التجميع
opts = {
    "append_file": append_file_name,
    "start_page": 1,
    "end_page": 2
}

# استدعاء API لدمج الصفحات
response = pdf_api.post_append_document(file_name, **opts)

# عرض رمز الاستجابة في وحدة التحكم
print(response)

دمج ملفات PDF باستخدام الأمر cURL

تُعد أوامر cURL إحدى الطرق المريحة للوصول إلى واجهات برمجة التطبيقات REST من خلال محطة سطر الأوامر لأي منصة. ولا تحتاج حتى إلى تثبيت SDK، بل ما عليك سوى تنفيذ الأمر في تطبيق المحطة وتلبية متطلباتك. لذا، لاستخدام أوامر cURL، فإن الخطوة الأولى هي إنشاء رمز ويب JSON (JWT) بحيث يمكن الوصول إلى واجهات برمجة التطبيقات من خلال موجه الأوامر. يتم استخدام نفس رمز JWT للوصول إلى واجهات برمجة التطبيقات من خلال أوامر cURL.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=a41d01ef-dfd5-4e02-ad29-bd85fe41e3e4&client_secret=d87269aade6a46cdc295b711e26809af" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

استخدم الأمر التالي وسيتم دمج ملف PDF المستهدف مع ملفات PDF المصدر/المدخلة باستخدام واجهة برمجة التطبيقات PostAppendDocument. يتم حفظ الناتج الناتج على وحدة تخزين سحابية.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/PdfWithAnnotations.pdf/appendDocument?appendFile=PdfWithTable.pdf&startPage=2&endPage=3" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"

خاتمة

في هذه المقالة، ناقشنا الخطوات اللازمة لإجراء عمليات دمج ملفات PDF باستخدام Python REST API. ونظرًا لنوع المصدر المفتوح، يمكن تنزيل الكود المصدر الكامل لمجموعة أدوات التطوير البرمجية من مستودع GitHub.

لمزيد من التفاصيل حول إمكانيات SDK، يرجى زيارة موضوع الوثائق التالي ميزات Aspose.PDF Cloud. ومع ذلك، إذا واجهت أي مشكلات أثناء استخدام واجهة برمجة التطبيقات، فلا تتردد في الاتصال بنا عبر منتدى الدعم الفني المجاني.

مقالات ذات صلة

نوصي أيضًا بقراءة المقالات التالية التي تشرح: