إضافة أو إزالة صفحات PDF باستخدام Python REST API

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

مجموعة أدوات معالجة ملفات PDF
إضافة صفحات إلى PDF باستخدام Python
حذف الصفحات من PDF باستخدام Python
إضافة صفحات PDF باستخدام الأمر cURL
حذف صفحات PDF باستخدام الأمر cURL

مجموعة أدوات معالجة ملفات PDF

Aspose.PDF Cloud عبارة عن واجهة برمجة تطبيقات تعتمد على REST وتوفر الإمكانيات اللازمة لإجراء إنشاء ومعالجة ملفات PDF. ولا يلزم تثبيت Adobe Acrobat أو أي برنامج آخر ويمكنك إجراء جميع العمليات في السحابة. وفقًا لنطاق هذه المقالة، سنستخدم Aspose.PDF Cloud SDK for Python لمعالجة ملفات PDF. هذه المجموعة عبارة عن غلاف حول واجهة برمجة التطبيقات REST، ويمكنك تنزيلها بحرية من مستودع PIP وGitHub. لذا، يرجى تنفيذ الأمر التالي على المحطة الطرفية/موجه الأوامر لتثبيت أحدث إصدار من مجموعة SDK.

pip install asposepdfcloud

مايكروسوفت فيجوال ستوديو

يمكنك أيضًا إضافة المرجع مباشرةً إلى مشروع Python الخاص بك ضمن مشروع Visual Studio. يُرجى البحث عن asposepdfcloud كحزمة ضمن نافذة بيئة Python. يُرجى اتباع الخطوات المرقمة في الصورة أدناه لإكمال عملية التثبيت.

Aspose.PDF Cloud Python — الصورة 1:- حزمة Aspose.PDF Cloud SDK لـ Python.

نظرًا لأن واجهات برمجة التطبيقات الخاصة بنا لا يمكن الوصول إليها إلا من قبل الأشخاص المصرح لهم، فأنت بحاجة أيضًا إلى إنشاء حساب على لوحة معلومات السحابة(في حالة عدم وجود حساب موجود).استخدم حساب GitHub أو Google لتسجيل الدخول أو انقر فوق الزر إنشاء حساب جديد وقم بتوفير المعلومات المطلوبة. ثم قم بتسجيل الدخول إلى لوحة المعلومات وتوسيع قسم التطبيقات على لوحة المعلومات. الآن قم بالتمرير لأسفل نحو قسم بيانات اعتماد العميل للحصول على تفاصيل معرف العميل والسر الخاصين بك.

الصورة 2: - بيانات اعتماد العميل على لوحة معلومات Aspose.Cloud.

إضافة صفحات إلى PDF باستخدام Python

يرجى اتباع الخطوات الموضحة أدناه لإضافة صفحات إلى مستند PDF باستخدام مقتطف كود Python:

أولاً، نحتاج إلى إنشاء مثيل لفئة ApiClient مع توفير معرف العميل وسر العميل كوسائط.
ثانيًا، قم بإنشاء مثيل لفئة PdfApi والتي تأخذ كائن ApiClient كحجة إدخال.
الآن قم باستدعاء الطريقة putaddnewpage(..) من فئة PdfApi، والتي تضيف صفحة فارغة في نهاية المستند. ثم يتم حفظ ملف PDF الناتج على التخزين السحابي.

def addPage():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

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

        #source image file
        input_file = 'URL2PDF.pdf'
        
        # إضافة صفحة في نهاية مستند PDF
        response = pdf_api.put_add_new_page(name = input_file)
        print(response)

        # طباعة الرسالة في وحدة التحكم (اختياري)
        print('Blank page successfully added to PDF !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)

حذف الصفحات من PDF باستخدام Python

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

أولاً، قم بإنشاء مثيل لفئة ApiClient مع توفير معرف العميل وسر العميل كوسائط.
ثانيًا، قم بإنشاء كائن من فئة PdfApi والذي يأخذ كائن ApiClient كحجة إدخال.
أخيرًا، قم باستدعاء طريقة deletepage(…) لإزالة الصفحة المحددة من مستند PDF.

def deletePage():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

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

        #source image file
        input_file = 'URL2PDF.pdf'
        
        # حذف الصفحة الثانية من مستند PDF
        response = pdf_api.delete_page(name = input_file, page_number=2)
        print(response)

        # طباعة الرسالة في وحدة التحكم (اختياري)
        print('Page successfully deleted from PDF !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)

إضافة صفحات PDF باستخدام الأمر cURL

توفر أوامر cURL طريقة ملائمة للوصول إلى واجهات برمجة تطبيقات REST من خلال محطة سطر الأوامر. نظرًا لأن Aspose.PDF Cloud تم تطويره وفقًا لهندسة REST، فيمكننا أيضًا استخدام أوامر cURL لإنجاز متطلباتنا. ومع ذلك، نظرًا لأن واجهات برمجة التطبيقات لا يمكن الوصول إليها إلا من قبل المستخدمين المصرح لهم، فنحن بحاجة أولاً إلى إنشاء رمز ويب JSON (JWT) استنادًا إلى بيانات اعتماد العميل الخاصة بنا. لذا، يرجى تنفيذ الأمر التالي لإنشاء رمز وصول JWT.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bbf94a2c-6d7e-4020-b4d2-b9809741374e&client_secret=1c9379bb7d701c26cc87e741a29987bb" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

يرجى تنفيذ الأمر التالي لإضافة صفحة فارغة في نهاية مستند PDF.

curl -v -X PUT "https://api.aspose.cloud/v3.0/pdf/URL2PDF.pdf/pages" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-d{}

حذف صفحات PDF باستخدام الأمر cURL

يمكننا أيضًا حذف صفحة PDF باستخدام الأمر cURL. لذا يرجى تنفيذ الأمر التالي لحذف الصفحة الثانية من ملف PDF.

curl -v -X DELETE "https://api.aspose.cloud/v3.0/pdf/URL2PDF.pdf/pages/2" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-d{}

خاتمة

في هذه المقالة، ناقشنا التفاصيل والخطوات حول كيفية إضافة أو إزالة الصفحات من مستندات PDF باستخدام واجهة برمجة التطبيقات REST. لقد استكشفنا الخيارات لإنجاز هذا المطلب إما باستخدام مقتطف كود Python أو باستخدام أوامر cURL. يتوفر الكود المصدر الكامل لـ Apsose.PDF Cloud SDK for Python للتنزيل عبر GitHub. أخيرًا، في حالة مواجهة أي مشكلات أثناء استخدام واجهة برمجة التطبيقات أو إذا كان لديك أي استفسارات ذات صلة، فلا تتردد في الاتصال بنا عبر منتدى دعم المنتج المجاني.

مجموعة أدوات معالجة ملفات PDF#

مايكروسوفت فيجوال ستوديو#

إضافة صفحات إلى PDF باستخدام Python#

حذف الصفحات من PDF باستخدام Python#

إضافة صفحات PDF باستخدام الأمر cURL#

حذف صفحات PDF باستخدام الأمر cURL#

خاتمة#

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