تحويل الصور إلى PDF باستخدام REST API في Python

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

سيتم تناول الموضوعات التالية في هذه المقالة:

صورة لتحويل PDF REST API و Python SDK

لتحويل صور JPG أو PNG إلى PDF ، سنستخدم Python SDK of GroupDocs.Conversion Cloud API. الرجاء تثبيته باستخدام الأمر التالي في وحدة التحكم:

pip install groupdocs_converison_cloud

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

# يوضح مثال الرمز هذا كيفية تعيين معرف العميل والسرية.
client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"

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

قم بتحويل JPG إلى PDF باستخدام واجهة برمجة تطبيقات REST في Python

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

  1. تحميل ملف صورة JPG إلى السحابة
  2. [تحويل JPG إلى PDF باستخدام Python](# Convert-JPG-to-PDF-using-Python)
  3. تنزيل ملف PDF المحول

قم بتحميل الصورة

أولاً ، سنقوم بتحميل ملف صورة JPG إلى السحابة باستخدام نموذج الكود التالي:

# يوضح مثال الرمز هذا كيفية تحميل ملف صورة JPG إلى السحابة.
# إنشاء مثيل من API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# طلب رفع الملف
request = groupdocs_conversion_cloud.UploadFileRequest("sample.jpg", "C:\\Files\\Conversion\\sample.jpg", my_storage)

# تحميل ملف عينة
response = file_api.upload_file(request)

نتيجة لذلك ، سيكون الملف الذي تم تحميله متاحًا في قسم الملفات من لوحة القيادة على السحابة.

قم بتحويل ملفات JPG إلى PDF باستخدام Python

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

  • أولاً ، قم بإنشاء مثيل لـ ConvertApi.
  • بعد ذلك ، قم بإنشاء مثيل لـ ConvertSettings.
  • ثم قم بتعيين مسار ملف JPG.
  • وقم بتعيين “pdf” للتنسيق.
  • أيضا ، قم بتوفير مسار ملف الإخراج.
  • بعد ذلك ، قم بإنشاء ConvertDocumentRequest باستخدام ConvertSettings كوسيطة.
  • أخيرًا ، قم باستدعاء الأسلوب ConvertApi.convert \ document() باستخدام ConvertDocumentRequest لحفظ الملف المحول.

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

# يوضح مثال الرمز هذا كيفية تحويل JPT إلى PDF.
# إنشاء مثيلات API الضرورية
يتحول_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# تحضير إعدادات التحويل
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "يتحولed"

# طلب تحويل
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# يتحول
result = يتحول_api.يتحول_document(request)

# منتهي
print("Document يتحولed: " + result[0].path)
قم بتحويل JPG إلى PDF باستخدام واجهة برمجة تطبيقات REST في Python.

قم بتحويل JPG إلى PDF باستخدام واجهة برمجة تطبيقات REST في Python.

قم بتنزيل ملف PDF المحول

نموذج الرمز أعلاه سيحفظ مستند PDF المحول على السحابة. يمكن تنزيله باستخدام مثال الكود التالي:

# يوضح مثال الرمز هذا كيفية تنزيل ملف PDF من السحابة.
# تهيئة API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# طلب تحميل الملف
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)

# تحميل الملف
response = file_api.download_file(request)

# انقل الملف الذي تم تنزيله إلى دليل العمل الخاص بك
shutil.move(response, "C:\\Files\\Conversion\\")

تحويل JPG إلى PDF مع خيارات متقدمة

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

  • أولاً ، قم بإنشاء مثيل لـ ConvertApi.
  • بعد ذلك ، قم بإنشاء مثيل لـ ConvertSettings.
  • ثم قم بتعيين مسار ملف JPG.
  • وقم بتعيين “pdf” للتنسيق.
  • أيضا ، قم بتوفير مسار ملف الإخراج.
  • بعد ذلك ، قم بإنشاء مثيل لـ PdfConvertOptions وقم بتعيينه إلى ConvertSettings.
  • بعد ذلك ، قم بتعيين إعدادات التحويل المختلفة مثل نقطة في البوصة ، وتدرج الرمادي ، والصورة \ الجودة ، والارتفاع ، والهوامش (أعلى ، يسار ، يمين ، أسفل) ، إلخ.
  • بعد ذلك ، قم بإنشاء ConvertDocumentRequest باستخدام ConvertSettings كوسيطة.
  • أخيرًا ، قم باستدعاء الأسلوب ConvertApi.convert \ document() باستخدام ConvertDocumentRequest لحفظ الملف المحول.

يوضح مثال الكود التالي كيفية تحويل صورة JPG إلى مستند PDF بخيارات تحويل متقدمة. يرجى اتباع الخطوات المذكورة سابقًا لتحميل ملف صورة JPG وتنزيل ملف PDF المحول.

# يوضح مثال الكود هذا كيفية تحويل JPT إلى PDF بخيارات متقدمة.
# إنشاء مثيلات API الضرورية
يتحول_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# تحضير إعدادات التحويل
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "يتحولed_with_options.pdf"

# خيارات تحويل PDF
يتحولOptions = groupdocs_conversion_cloud.PdfConvertOptions()
يتحولOptions.center_window = True
يتحولOptions.display_doc_title = True
يتحولOptions.dpi = 1024.0
يتحولOptions.fit_window = False
يتحولOptions.grayscale = True
يتحولOptions.image_quality = 100
يتحولOptions.linearize = True
يتحولOptions.margin_top = 500
يتحولOptions.margin_left = 500
يتحولOptions.margin_right = 500
يتحولOptions.margin_bottom = 500

settings.يتحول_options = يتحولOptions

# طلب تحويل
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# يتحول
result = يتحول_api.يتحول_document(request)

# منتهي
print("Document يتحولed: " + result[0].path)
تحويل JPG إلى PDF مع خيارات متقدمة.

تحويل JPG إلى PDF مع خيارات متقدمة.

قم بتحويل ملفات JPG إلى PDF باستخدام علامة مائية في لغة Python

يمكننا تحويل JPG إلى مستند PDF ثم إضافة علامة مائية إلى ملف PDF المحول برمجيًا باتباع الخطوات الواردة أدناه:

  • أولاً ، قم بإنشاء مثيل لـ ConvertApi.
  • بعد ذلك ، قم بإنشاء مثيل لـ ConvertSettings.
  • بعد ذلك ، قم بتعيين مسار ملف JPG ، وقم بتعيين “pdf” للتنسيق وتوفير مسار ملف الإخراج.
  • بعد ذلك ، قم بإنشاء مثيل لـ WatermarkOptions.
  • بعد ذلك ، قم بتعيين نص العلامة المائية ، واللون ، والخط \ الحجم ، والدوران \ الزاوية ، وما إلى ذلك.
  • بعد ذلك ، قم بإنشاء مثيل لـ PdfConvertOptions وقم بتعيينه إلى WatermarkOptions.
  • بعد ذلك ، قم بتعيين إعدادات التحويل المختلفة اختياريًا.
  • وقم بتعيين PdfConvertOptions إلى ConvertSettings.
  • بعد ذلك ، قم بإنشاء ConvertDocumentRequest باستخدام ConvertSettings كوسيطة.
  • أخيرًا ، قم باستدعاء الأسلوب ConvertApi.convert \ document() باستخدام ConvertDocumentRequest لحفظ الملف المحول.

يوضح مثال الكود التالي كيفية تحويل JPG إلى مستند PDF وإضافة علامة مائية إلى مستند PDF المحول باستخدام REST API في Python.

# يوضح مثال الرمز هذا كيفية تحويل JPT إلى PDF وإضافة علامة مائية إلى PDF المحول.
# تهيئة API
convert_api = groupdocs_conversion_cloud.يتحولApi.from_keys(client_id, client_secret)

# تحديد إعدادات التحويل
settings = groupdocs_conversion_cloud.يتحولSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "converted"

# تحديد خيارات العلامة المائية
watermark = groupdocs_conversion_cloud.WatermarkOptions()
watermark.text = "THIS IS SAMPLE WATERMARK"
watermark.bold = True;
watermark.font_size = 34;
watermark.color = "Black";
watermark.background = False;
watermark.rotation_angle = 30;
watermark.left = 90;
watermark.top = 500;

# حدد خيارات تحويل PDF
convertOptions = groupdocs_conversion_cloud.PdfيتحولOptions()
convertOptions.watermark_options = watermark

settings.convert_options = convertOptions

# إنشاء طلب تحويل المستند
request = groupdocs_conversion_cloud.يتحولDocumentRequest(settings)
# يتحول
result = convert_api.convert_document(request)
print("Document converted successfully: " + result[0].url)
قم بتحويل ملفات JPG إلى PDF باستخدام علامة مائية في لغة Python.

قم بتحويل ملفات JPG إلى PDF باستخدام علامة مائية في لغة Python.

قم بتحويل ملفات JPG إلى PDF وتنزيل الملف مباشرة

يمكننا تحويل JPG إلى PDF برمجيًا وتنزيل ملف PDF المحول مباشرةً باتباع الخطوات الواردة أدناه:

  • أولاً ، قم بإنشاء مثيل لـ ConvertApi.
  • بعد ذلك ، قم بإنشاء مثيل لـ ConvertSettings.
  • ثم قم بتعيين مسار ملف JPG.
  • وقم بتعيين “pdf” للتنسيق.
  • أيضًا ، قم بتوفير مسار ملف الإخراج كـ None.
  • بعد ذلك ، قم بإنشاء ConvertDocumentRequest باستخدام ConvertSettings كوسيطة.
  • أخيرًا ، قم باستدعاء أسلوب ConvertApi.convert \ document \ download() باستخدام ConvertDocumentRequest لحفظ الملف المحول على القرص المحلي.

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

# يوضح مثال الكود هذا كيفية التحويل والتنزيل.
# إنشاء مثيلات API الضرورية
convert_api = groupdocs_conversion_cloud.يتحولApi.from_keys(client_id, client_secret)

# تحضير إعدادات التحويل
settings = groupdocs_conversion_cloud.يتحولSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"

settings.output_path = None    # leave OutputPath will result the output as document IOStream

# اعداد الطلب
request = groupdocs_conversion_cloud.يتحولDocumentRequest(settings)

# يتحول
response = convert_api.convert_document_download(request)

# انقل الملف الذي تم تنزيله إلى دليل العمل الخاص بك
shutil.move(response, "C:\\Files\\Conversion\\")

تحويل JPG إلى PDF بدون استخدام التخزين السحابي

يمكننا تحويل JPG إلى PDF دون استخدام التخزين السحابي باتباع الخطوات الواردة أدناه:

  • أولاً ، قم بإنشاء مثيل لـ ConvertApi
  • بعد ذلك ، قم بإنشاء ConvertDocumentDirectRequest بالتنسيق الهدف ومسار ملف صورة الإدخال كوسائط.
  • ثم قم باستدعاء الأسلوب convert \ document \ direct() باستخدام ConvertDocumentDirectRequest كوسيطة.
  • أخيرًا ، احفظ ملف PDF الناتج المحول إلى المسار المحلي باستخدام طريقة FileStream.writeFile().

يوضح نموذج التعليمات البرمجية التالي كيفية تحويل JPG إلى مستند PDF بدون استخدام التخزين السحابي. هذا يعني أننا سنمرر ملف الإدخال في نص الطلب ونتلقى ملف الإخراج في استجابة API.

# يوضح مثال الرمز هذا كيفية تحويل JPT إلى PDF دون استخدام التخزين السحابي.
# إنشاء مثيلات API الضرورية
convert_api = groupdocs_conversion_cloud.يتحولApi.from_keys(client_id, client_secret)

# اعداد الطلب
request = groupdocs_conversion_cloud.يتحولDocumentDirectRequest("pdf", "C:\\Files\\Conversion\\sample.jpg")

# يتحول
result = convert_api.convert_document_direct(request)

# انقل الملف الذي تم تنزيله إلى دليل العمل الخاص بك
shutil.move(result, "C:\\Files\\Conversion\\")

جرب عبر الإنترنت

يرجى تجربة أداة تحويل JPG المجانية التالية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/conversion/

خاتمة

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

أنظر أيضا