ویرایش پاورپوینت با استفاده از پایتون

به عنوان یک توسعه دهنده پایتون، می توانید به راحتی ارائه های پاورپوینت را به صورت برنامه ای ویرایش کنید. شما می توانید محتوای اسلاید را بدون نصب هیچ برنامه خارجی با استفاده از پایتون به روز کنید. این مقاله بر روی نحوه ویرایش ارائه های پاورپوینت با استفاده از REST API در پایتون تمرکز خواهد داشت.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

ویرایشگر سند REST API و Python SDK

برای ویرایش PPTX، از Python SDK of GroupDocs.Editor Cloud API استفاده خواهم کرد. این به شما امکان می دهد اسناد پردازش ورد، برگه های اکسل یا اسناد دیگر فرمت های پشتیبانی شده را به صورت برنامه نویسی ویرایش کنید. همچنین SDKهای .NET، جاوا، PHP، Ruby، Android و Node.js را به عنوان [اعضای خانواده ویرایشگر سند3 برای Cloud API ارائه می‌کند.

می توانید GroupDocs.Editor-Cloud را با استفاده از دستور زیر در کنسول در پروژه پایتون خود نصب کنید:

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 = ""

ارائه های پاورپوینت را با استفاده از REST API در پایتون ویرایش کنید

می توانید با دنبال کردن مراحل ساده زیر، ارائه پاورپوینت را ویرایش کنید:

  1. آپلود فایل PPTX را در Cloud
  2. ویرایش فایل آپلود شده
  3. دانلود فایل به روز شده

سند را آپلود کنید

اول از همه، ارائه پاورپوینت را با استفاده از مثال کد زیر در Cloud آپلود کنید:

# ایجاد نمونه ای از api
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 در فضای ذخیره‌سازی ابری آپلود می‌شود و در بخش فایل‌ها داشبورد شما در دسترس خواهد بود.

ویرایش پاورپوینت با استفاده از پایتون

لطفا مراحل ذکر شده در زیر را برای ویرایش ارائه پاورپوینت به صورت برنامه ای دنبال کنید.

  • نمونه های File API و Edit API را ایجاد کنید
  • مسیر فایل ورودی را ارائه دهید
  • PresentationLoadOptions را ارائه دهید
  • یک فایل را با روش Load ویرایش API بارگیری کنید
  • سند HTML را با استفاده از روش Download File File API دانلود کنید
  • سند HTML دانلود شده را ویرایش کنید
  • با استفاده از روش Upload File File API، HTML را دوباره آپلود کنید
  • PresentationSaveOptions را برای ذخیره در PPTX ارائه دهید
  • با استفاده از روش Save Edit API، HTML را به PPTX برگردانید

قطعه کد زیر نحوه به روز رسانی یک سند ارائه پاورپوینت را با استفاده از REST API نشان می دهد.

# مقداردهی اولیه 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)
ویرایش پاورپوینت با استفاده از پایتون

ویرایش پاورپوینت با استفاده از پایتون

فایل به روز شده را دانلود کنید

نمونه کد بالا فایل ارائه پاورپوینت (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\\")

به روز رسانی تصاویر در ارائه پاورپوینت با استفاده از پایتون

لطفاً مراحل ذکر شده در زیر را دنبال کنید تا تصویر موجود در ارائه پاورپوینت را به صورت برنامه ای به روز کنید.

  • نمونه های File API و Edit API را ایجاد کنید
  • مسیر فایل ورودی را ارائه دهید
  • PresentationLoadOptions را ارائه دهید
  • یک فایل را با روش Load ویرایش API بارگیری کنید
  • سند HTML را با استفاده از روش Download File File API دانلود کنید
  • فایل تصویری را آپلود کنید
  • سند HTML دانلود شده را ویرایش کنید and update the image
  • با استفاده از روش Upload File File API، HTML را دوباره آپلود کنید
  • PresentationSaveOptions را برای ذخیره در PPTX ارائه دهید
  • با استفاده از روش Save Edit API، HTML را به PPTX برگردانید

قطعه کد زیر نحوه به روز رسانی یک تصویر در اسلاید ارائه پاورپوینت را با استفاده از REST API نشان می دهد.

# مقداردهی اولیه 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” در این مورد قرار می گیرند. شما باید تصویر را در این دایرکتوری آپلود کنید و سپس آن را با تصویر هدف جایگزین کنید. تمام تصاویر موجود در اسلاید با ویژگی “src”، تصویر 2، تصویر 3 و غیره نامگذاری شده اند.

آنلاین را امتحان کنید

لطفاً ابزار ویرایش پاورپوینت آنلاین رایگان زیر را که با استفاده از API بالا ایجاد شده است، امتحان کنید. https://products.groupdocs.app/editor/pptx

نتیجه

در این مقاله، نحوه ویرایش ارائه های پاورپوینت در فضای ابری را با استفاده از برنامه ویرایشگر سند REST API با استفاده از پایتون یاد گرفتید. همچنین یاد گرفتید که چگونه فایل PPTX را به صورت برنامه‌نویسی در فضای ابری آپلود کنید و سپس فایل به‌روز شده را از ابر دانلود کنید. می توانید با استفاده از مستندات درباره GroupDocs.Editor Cloud API بیشتر بیاموزید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آن‌ها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در تالار گفتمان تماس بگیرید.

همچنین ببینید