تحرير PowerPoint باستخدام Python

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

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

محرر المستندات REST API و Python SDK

لتحرير PPTX ، سأستخدم Python SDK of GroupDocs.Editor Cloud API. يسمح لك بتحرير مستندات معالجة الكلمات أو أوراق Excel أو المستندات ذات التنسيقات المدعومة الأخرى برمجيًا. كما أنها توفر حزم SDK لـ NET و Java و PHP و Ruby و Android و Node.js باعتبارها أعضاء عائلة محرر المستندات لواجهة برمجة التطبيقات السحابية.

يمكنك تثبيت GroupDocs.Editor-Cloud لمشروع Python الخاص بك باستخدام الأمر التالي في وحدة التحكم:

pip install groupdocs_editor_cloud

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

client_id = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5"
client_secret = "479db2b01dcb93a3d4d20efb16dea971"

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

قم بتحرير عروض PowerPoint التقديمية باستخدام REST API في Python

يمكنك تعديل عرض PowerPoint التقديمي باتباع الخطوات البسيطة المذكورة أدناه:

  1. تحميل ملف PPTX إلى السحابة
  2. تحرير الملف المرفوع
  3. [تحميل](# تحميل الملف) الملف المحدث

قم بتحميل المستند

بادئ ذي بدء ، قم بتحميل عرض PowerPoint التقديمي على السحابة باستخدام مثال الرمز الموضح أدناه:

# إنشاء مثيل لواجهة برمجة التطبيقات
file_api = groupdocs_editor_cloud.FileApi.from_config(configuration)

# تحميل ملف عينة
request = groupdocs_editor_cloud.UploadFileRequest("sample.pptx", "C:\\Files\\sample.pptx", my_storage)
response = file_api.upload_file(request)

نتيجة لذلك ، سيتم تحميل ملف PPTX إلى Cloud Storage وسيكون متاحًا في قسم الملفات من لوحة المعلومات الخاصة بك.

تحرير PowerPoint Presentation باستخدام Python

يرجى اتباع الخطوات المذكورة أدناه لتعديل عرض PowerPoint التقديمي برمجيًا.

  • قم بتكوين مثيلات File API و Edit API
  • قم بتوفير مسار ملف الإدخال
  • توفير PresentationLoadOptions
  • قم بتحميل ملف بطريقة تحميل لتحرير API
  • قم بتنزيل مستند HTML باستخدام طريقة Download File من File API
  • قم بتحرير مستند HTML الذي تم تنزيله
  • قم بتحميل HTML مرة أخرى باستخدام طريقة تحميل ملف من File API
  • توفير PresentationSaveOptions للحفظ في PPTX
  • احفظ HTML مرة أخرى إلى PPTX باستخدام طريقة حفظ لتحرير API

يوضح مقتطف التعليمات البرمجية التالي كيفية تحديث مستند عرض PowerPoint تقديمي باستخدام واجهة برمجة تطبيقات REST.

# تهيئة API
editApi = groupdocs_editor_cloud.EditApi.from_keys(client_id, client_secret)
fileApi = groupdocs_editor_cloud.FileApi.from_keys(client_id, client_secret)

# تحميله في حالة قابلة للتحرير
fileInfo = groupdocs_editor_cloud.FileInfo("sample.pptx")
loadOptions = groupdocs_editor_cloud.PresentationLoadOptions()
loadOptions.file_info = fileInfo
loadOptions.output_path = "output"
loadOptions.slide_number = 0
loadOptions.show_hidden_slides = True
loadResult = editApi.load(groupdocs_editor_cloud.LoadRequest(loadOptions)) 

# تنزيل مستند html
htmlFile = fileApi.download_file(groupdocs_editor_cloud.DownloadFileRequest(loadResult.html_path))
html = ""     

# قراءة ملف HTML
with open(htmlFile, 'r') as file:
    html = file.read() 

# استبدال النص    
html = html.replace("Hello World", "Welcome")

# تحميل HTML مرة أخرى إلى التخزين
with open(htmlFile, 'w') as file:
    file.write(html)

fileApi.upload_file(groupdocs_editor_cloud.UploadFileRequest(loadResult.html_path, htmlFile))

# احفظ HTML مرة أخرى إلى PPTX
saveOptions = groupdocs_editor_cloud.PresentationSaveOptions()
saveOptions.file_info = fileInfo
saveOptions.output_path = "edited.pptx"
saveOptions.html_path = loadResult.html_path
saveOptions.resources_path = loadResult.resources_path
saveOptions.password = "password"
saveResult = editApi.save(groupdocs_editor_cloud.SaveRequest(saveOptions))

# منتهي
print("Document edited: " + saveResult.path)
تحرير عرض PowerPoint التقديمي باستخدام Python

تحرير عرض PowerPoint التقديمي باستخدام Python

قم بتنزيل الملف المحدث

سيحفظ نموذج الكود أعلاه ملف PowerPoint التقديمي المحرر (PPTX) على السحابة. يمكنك تنزيله باستخدام نموذج التعليمات البرمجية التالي:

# تهيئة API
file_api = groupdocs_editor_cloud.FileApi.from_config(configuration)

# تحميل الملف
request = groupdocs_editor_cloud.DownloadFileRequest("edited.pptx", my_storage)
response = file_api.download_file(request)

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

تحديث الصور في PowerPoint Presentation باستخدام Python

يرجى اتباع الخطوات المذكورة أدناه لتحديث الصورة في عرض PowerPoint برمجيًا.

  • قم بتكوين مثيلات File API و Edit API
  • قم بتوفير مسار ملف الإدخال
  • توفير PresentationLoadOptions
  • قم بتحميل ملف باستخدام طريقة تحميل لتحرير API
  • قم بتنزيل مستند HTML باستخدام طريقة Download File من File API
  • تحميل ملف الصورة
  • قم بتحرير مستند HTML الذي تم تنزيله and update the image
  • قم بتحميل HTML مرة أخرى باستخدام طريقة تحميل ملف من File API
  • توفير PresentationSaveOptions للحفظ في PPTX
  • احفظ HTML مرة أخرى إلى PPTX باستخدام طريقة حفظ لتحرير API

يوضح مقتطف التعليمات البرمجية التالي كيفية تحديث صورة على شريحة العرض التقديمي PowerPoint باستخدام واجهة برمجة تطبيقات REST.

# تهيئة API
editApi = groupdocs_editor_cloud.EditApi.from_keys(client_id, client_secret)
fileApi = groupdocs_editor_cloud.FileApi.from_keys(client_id, client_secret)

# تحميله في حالة قابلة للتحرير
fileInfo = groupdocs_editor_cloud.FileInfo("sample.pptx")
loadOptions = groupdocs_editor_cloud.PresentationLoadOptions()
loadOptions.file_info = fileInfo
loadOptions.output_path = "output"
loadOptions.slide_number = 0
loadResult = editApi.load(groupdocs_editor_cloud.LoadRequest(loadOptions)) 

# تنزيل مستند html
htmlFile = fileApi.download_file(groupdocs_editor_cloud.DownloadFileRequest(loadResult.html_path))
html = ""     

# قراءة ملف HTML
with open(htmlFile, 'r') as file:
    html = file.read() 

# تحميل الصورة لاستبدالها
request = groupdocs_editor_cloud.UploadFileRequest(loadOptions.output_path + "/sample.files/groupdocs.png", "C:\\Files\\groupdocs.png", "")
response = fileApi.upload_file(request)

# استبدل الصورة   
html = html.replace("Picture 2.png", "groupdocs.png")

# تحميل HTML مرة أخرى إلى التخزين
with open(htmlFile, 'w') as file:
    file.write(html)

fileApi.upload_file(groupdocs_editor_cloud.UploadFileRequest(loadResult.html_path, htmlFile))

# احفظ HTML مرة أخرى إلى PPTX
saveOptions = groupdocs_editor_cloud.PresentationSaveOptions()
saveOptions.file_info = fileInfo
saveOptions.output_path = "edited.pptx"
saveOptions.html_path = loadResult.html_path
saveOptions.resources_path = loadResult.resources_path
saveResult = editApi.save(groupdocs_editor_cloud.SaveRequest(saveOptions))
تحديث الصورة في شريحة عرض بوربوينت

تحديث الصورة في شريحة عرض بوربوينت

يقوم API بإنشاء ملف HTML في PresentationLoadOptions.output \ path المحدد. يتم وضع جميع ملفات الموارد المرتبطة بملف HTML الذي تم إنشاؤه في دليل فرعي للملفات مسبوقًا باسم ملف الإدخال مثل “sample.files” في هذه الحالة. تحتاج إلى تحميل الصورة في هذا الدليل ثم استبدالها بالصورة المستهدفة. يتم تسمية جميع الصور الموجودة على الشريحة باسم Picture 2 ، و Picture 3 ، وما إلى ذلك في سمة “src”.

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

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

خاتمة

في هذه المقالة ، تعلمت كيفية تحرير عروض PowerPoint التقديمية على السحابة باستخدام Document Editor REST API باستخدام Python. لقد تعلمت أيضًا كيفية تحميل ملف PPTX برمجيًا على السحابة ثم تنزيل الملف المحدث من السحابة. يمكنك معرفة المزيد حول GroupDocs.Editor Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، فلا تتردد في الاتصال بنا على المنتدى.

أنظر أيضا