به اشتراک گذاری اسناد Word در قالب PDF یک روش معمول است زیرا PDF یک فرمت اشتراک گذاری اسناد پرکاربرد در صنعت است. شما به راحتی می توانید Word را به PDF با استفاده از عملکرد داخلی ارائه شده توسط Microsoft Office تبدیل کنید، اما ممکن است لازم باشد اسناد Word خود (DOC یا DOCX) را به صورت برنامه ریزی شده به PDF تبدیل کنید. در این مقاله با نحوه تبدیل اسناد Word به PDF با استفاده از REST API در پایتون آشنا خواهید شد.
موضوعات زیر در این مقاله پوشش داده خواهد شد:
- تبدیل Word به PDF REST API و Python SDK
- با استفاده از REST API در پایتون، اسناد Word را به PDF تبدیل کنید
- تبدیل Word به PDF با گزینه های پیشرفته
- تبدیل محدوده صفحات از DOCX به PDF در پایتون
- تبدیل صفحات خاص DOCX به PDF در پایتون
- تبدیل Word به PDF با واترمارک با استفاده از پایتون
- تبدیل DOCX به PDF بدون استفاده از Cloud Storage
- تبدیل DOCX به PDF و دانلود مستقیم
تبدیل Word به PDF REST API و Python SDK
برای تبدیل DOCX به PDF، از Python SDK of GroupDocs.Conversion Cloud API استفاده خواهیم کرد. این یک راه حل تبدیل سند/تصویر مستقل از پلتفرم است و به هیچ ابزار یا نرم افزاری وابستگی ندارد. این به شما امکان می دهد تا به سرعت و با اطمینان تصاویر و اسناد را از هر فرمت فایل پشتیبانی شده به هر فرمتی که نیاز دارید تبدیل کنید.
می توانید GroupDocs.Conversion Cloud را در برنامه پایتون خود با استفاده از دستور زیر در کنسول نصب کنید:
pip install groupdocs_conversion_cloud
لطفاً قبل از انجام مراحل ذکر شده [شناسه مشتری و راز خود را از داشبورد 5 دریافت کنید. هنگامی که شناسه و راز خود را دریافت کردید، کد را مطابق شکل زیر اضافه کنید:
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 = ""
با استفاده از REST API در پایتون، اسناد Word را به PDF تبدیل کنید
با دنبال کردن مراحل ساده زیر می توانید اسناد Word خود را به صورت برنامه نویسی در فضای ابری به PDF تبدیل کنید:
- آپلود فایل DOCX را در ابر
- تبدیل DOCX به PDF با استفاده از Python
- دانلود فایل PDF تبدیل شده
فایل DOCX را آپلود کنید
ابتدا فایل DOCX را با استفاده از نمونه کد زیر در فضای ابری آپلود کنید:
# نمونه ای از API ایجاد کنید
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)
# درخواست آپلود فایل
request = groupdocs_conversion_cloud.UploadFileRequest("sample.docx", "C:\\Files\\Conversion\\sample.docx", my_storage)
# فایل نمونه را آپلود کنید
response = file_api.upload_file(request)
در نتیجه، فایل DOCX آپلود شده در بخش فایل‌ها داشبورد شما در فضای ابری در دسترس خواهد بود.
تبدیل DOCX به PDF با استفاده از پایتون
با دنبال کردن مراحل ذکر شده در زیر می‌توانید به راحتی DOCX را به صورت برنامه‌نویسی به سند PDF تبدیل کنید:
- ابتدا یک نمونه از ConvertApi ایجاد کنید.
- اکنون، یک نمونه از ConvertSettings ایجاد کنید.
- سپس، مسیر فایل ورودی DOCX را ارائه دهید.
- قالب را به عنوان “pdf” تنظیم کنید.
- مسیر فایل خروجی را ارائه دهید.
- اکنون، ConvertDocumentRequest را با ConvertSettings ایجاد کنید.
- در نهایت، با فراخوانی متد convert\document() با ConvertDocumentRequest، DOCX را تبدیل کنید.
مثال کد زیر نحوه تبدیل DOCX به PDF را با استفاده از REST API در پایتون نشان می دهد.
# یک نمونه از API ایجاد کنید
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)
# تنظیمات تبدیل را تعریف کنید
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.docx"
settings.format = "pdf"
settings.output_path = "converted"
# ایجاد درخواست تبدیل سند
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# تبدیل سند
result = convert_api.convert_document(request)
# انجام شده
print("Document converted: " + result[0].path)
با استفاده از REST API در پایتون، اسناد Word را به 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\\")
تبدیل Word به PDF با گزینه های پیشرفته
با انجام مراحل زیر می توانید اسناد Word را با تنظیمات پیشرفته به فایل های PDF تبدیل کنید:
- ابتدا یک نمونه از ConvertApi ایجاد کنید.
- اکنون، یک نمونه از ConvertSettings ایجاد کنید.
- سپس، مسیر فایل DOCX را ارائه دهید.
- “pdf” را به عنوان فرمت تنظیم کنید.
- مسیر فایل خروجی را ارائه دهید.
- اکنون یک نمونه از DocxLoadOptions ایجاد کنید
- به صورت اختیاری گزینه های بارگذاری مختلف مانند hide\comments، hide\word\ tracked\changes و غیره را تنظیم کنید.
- اکنون، یک نمونه از PdfConvertOptions ایجاد کنید
- سپس گزینه های مختلف تبدیل مانند display\doc\title، حاشیه (بالا، چپ، راست، پایین) و غیره را تنظیم کنید.
- اکنون، ConvertDocumentRequest را با ConvertSettings ایجاد کنید
- در نهایت، با فراخوانی متد convert\document() با ConvertDocumentRequest، DOCX را تبدیل کنید.
مثال کد زیر نحوه تبدیل یک سند Word به یک سند PDF را با گزینه های تبدیل پیشرفته نشان می دهد. لطفاً برای آپلود و دانلود یک فایل مراحل ذکر شده را دنبال کنید.
# یک نمونه از API ایجاد کنید
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)
# تنظیمات تبدیل را تعریف کنید
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.docx"
settings.format = "pdf"
settings.output_path = "converted"
# گزینه های بارگذاری DOCX
loadOptions = groupdocs_conversion_cloud.DocxLoadOptions()
loadOptions.hide_comments = True # Hide comments
loadOptions.hide_word_tracked_changes = True # Hide tracked changes
# گزینه های تبدیل PDF
convertOptions = groupdocs_conversion_cloud.PdfConvertOptions()
convertOptions.center_window = True
convertOptions.compress_images = False
convertOptions.display_doc_title = True
convertOptions.dpi = 1024.0
convertOptions.fit_window = False
convertOptions.from_page = 1
convertOptions.grayscale = False
convertOptions.image_quality = 100
convertOptions.linearize = False
convertOptions.margin_top = 5
convertOptions.margin_left = 5
convertOptions.unembed_fonts = True
convertOptions.remove_unused_streams = True
convertOptions.remove_unused_objects = True
convertOptions.remove_pdfa_compliance = False
settings.convert_options = convertOptions
# تبدیل درخواست سند
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# تبدیل سند
result = convert_api.convert_document(request)
# انجام شده
print("Document converted: " + result[0].path)
تبدیل محدوده صفحات از DOCX به PDF در پایتون
با دنبال کردن مراحل ذکر شده در زیر می‌توانید طیف وسیعی از صفحات را از یک سند Word به یک فایل PDF به صورت برنامه‌نویسی تبدیل کنید:
- ابتدا یک نمونه از ConvertApi ایجاد کنید
- اکنون، یک نمونه از ConvertSettings ایجاد کنید
- سپس، مسیر فایل ورودی DOCX را ارائه دهید
- “pdf” را به قالب اختصاص دهید
- مسیر فایل خروجی را ارائه دهید
- اکنون، یک نمونه از PdfConvertOptions ایجاد کنید
- سپس، یک محدوده صفحه برای تبدیل از شماره صفحه شروع و کل صفحات برای تبدیل ارائه کنید
- اکنون، PdfConvertOptions را به ConvertSettings اختصاص دهید
- سپس، ConvertDocumentRequest را با ConvertSettings ایجاد کنید
- در نهایت با فراخوانی متد convert\document() با ConvertDocumentRequest تبدیل کنید.
نمونه کد زیر نحوه تبدیل طیف وسیعی از صفحات از DOCX به PDF را با استفاده از REST API در پایتون نشان می دهد. لطفاً برای آپلود و دانلود یک فایل مراحل ذکر شده را دنبال کنید.
# یک نمونه از API ایجاد کنید
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)
# تنظیمات تبدیل را تعریف کنید
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.docx"
settings.format = "pdf"
settings.output_path = "converted"
# گزینه های تبدیل PDF
convertOptions = groupdocs_conversion_cloud.PdfConvertOptions()
convertOptions.from_page = 1; # start page number
convertOptions.pages_count = 2; # total pages to convert
settings.convert_options = convertOptions
# تبدیل درخواست سند
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# تبدیل سند
result = convert_api.convert_document(request)
# انجام شده
print("Document converted: " + result[0].path)
تبدیل صفحات خاص DOCX به PDF در پایتون
با دنبال کردن مراحل ذکر شده در زیر می توانید صفحات خاصی از یک سند Word را به صورت برنامه نویسی به فایل PDF تبدیل کنید:
- ابتدا یک نمونه از ConvertApi ایجاد کنید
- اکنون، یک نمونه از ConvertSettings ایجاد کنید
- سپس، مسیر فایل ورودی DOCX را ارائه دهید
- “pdf” را به قالب اختصاص دهید
- مسیر فایل خروجی را ارائه دهید
- اکنون، یک نمونه از PdfConvertOptions ایجاد کنید
- سپس، شماره صفحات خاصی را در یک آرایه جدا شده با کاما برای تبدیل ارائه کنید
- اکنون، PdfConvertOptions را به ConvertSettings اختصاص دهید
- سپس، ConvertDocumentRequest را با ConvertSettings ایجاد کنید
- در نهایت با فراخوانی متد convert\cocument() با ConvertDocumentRequest تبدیل کنید.
مثال کد زیر نحوه تبدیل صفحات خاص یک سند Word به PDF را با استفاده از REST API در پایتون نشان می دهد. لطفاً برای آپلود و دانلود یک فایل مراحل ذکر شده را دنبال کنید.
# یک نمونه از API ایجاد کنید
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)
# تنظیمات تبدیل را تعریف کنید
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.docx"
settings.format = "pdf"
settings.output_path = "converted"
# گزینه های تبدیل PDF
convertOptions = groupdocs_conversion_cloud.PdfConvertOptions()
convertOptions.pages = [1,2]; # page numbers to convert
settings.convert_options = convertOptions
# تبدیل درخواست سند
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# تبدیل سند
result = convert_api.convert_document(request)
# انجام شده
print("Document converted: " + result[0].path)
تبدیل Word به PDF با واترمارک با استفاده از پایتون
با دنبال کردن مراحل زیر می توانید اسناد Word را به اسناد PDF تبدیل کنید و به اسناد تبدیل شده واترمارک اضافه کنید:
- ابتدا یک نمونه از ConvertApi ایجاد کنید
- اکنون، یک نمونه از ConvertSettings ایجاد کنید
- سپس، مسیر فایل ورودی DOCX را ارائه دهید
- “pdf” را به قالب اختصاص دهید
- مسیر فایل خروجی را ارائه دهید
- اکنون یک نمونه از WatermarkOptions ایجاد کنید
- سپس، متن واترمارک، رنگ، عرض، ارتفاع، چپ، بالا و غیره را تنظیم کنید.
- اکنون PdfConvertOptions را تعریف کرده و WatermarkOptions را اختصاص دهید
- اکنون، ConvertDocumentRequest را با ConvertSettings ایجاد کنید
- در نهایت، با فراخوانی متد convert\document() با ConvertDocumentRequest، DOCX را تبدیل کنید.
مثال کد زیر نحوه تبدیل یک سند Word به سند PDF و اضافه کردن واترمارک به سند PDF تبدیل شده با استفاده از REST API در پایتون را نشان می دهد. لطفاً برای آپلود و دانلود فایل ها مراحل ذکر شده قبلی را دنبال کنید.
# مقداردهی اولیه API
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)
# تنظیمات تبدیل را تعریف کنید
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.docx"
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 = "Gray";
watermark.background = False;
watermark.rotation_angle = 30;
watermark.left = 90;
watermark.top = 500;
# تعریف گزینه های تبدیل PDF
convertOptions = groupdocs_conversion_cloud.PdfConvertOptions()
convertOptions.watermark_options = watermark
settings.convert_options = convertOptions
# ایجاد درخواست تبدیل سند
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# تبدیل سند
result = convert_api.convert_document(request)
print("Document converted successfully: " + result[0].url)
تبدیل Word به PDF با واترمارک با استفاده از پایتون.
تبدیل DOCX به PDF بدون استفاده از Cloud Storage
شما می توانید یک سند Word را بدون استفاده از فضای ذخیره سازی ابری با عبور آن در بدنه درخواست و دریافت فایل خروجی در پاسخ API به PDF تبدیل کنید. لطفاً مراحل ذکر شده در زیر را برای تبدیل یک DOCX به PDF بدون استفاده از فضای ذخیره سازی ابری دنبال کنید.
- ابتدا یک نمونه از ConvertApi ایجاد کنید
- فایل ورودی DOCX را از مسیر محلی بخوانید
- اکنون ConvertDocumentDirectRequest را ایجاد کنید
- سپس فرمت مورد نظر را به صورت “pdf” و مسیر فایل ورودی را به عنوان پارامترهای ورودی ارائه دهید
- با فراخوانی متد convert\document\direct() با ConvertDocumentDirectRequest نتیجه بگیرید
- در نهایت فایل خروجی را با استفاده از متد ()FileStream.writeFile در مسیر محلی ذخیره کنید
مثال کد زیر نحوه تبدیل یک سند Word به PDF را بدون استفاده از فضای ذخیره سازی ابری نشان می دهد.
# یک نمونه از API ایجاد کنید
convert_api = groupdocs_conversion_cloud.تبدیلApi.from_keys(client_id, client_secret)
# ایجاد درخواست تبدیل
request = groupdocs_conversion_cloud.تبدیلDocumentDirectRequest("pdf", "C:\\Files\\Conversion\\sample.docx")
# تبدیل
result = convert_api.convert_document_direct(request)
# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(result, "C:\\Files\\Conversion\\")
تبدیل DOCX به PDF و دانلود مستقیم
می‌توانید با دنبال کردن مراحل زیر، DOCX را به اسناد PDF تبدیل کنید و فایل تبدیل شده را مستقیماً دانلود کنید:
- ابتدا یک نمونه از ConvertApi ایجاد کنید
- اکنون، یک نمونه از ConvertSettings ایجاد کنید
- سپس مسیر فایل DOCX را تنظیم کنید
- “pdf” را به قالب اختصاص دهید
- “None” را روی مسیر خروجی تنظیم کنید
- اکنون، ConvertDocumentRequest را با ConvertSettings ایجاد کنید
- سپس با فراخوانی متد convert\document\download() به نتیجه برسید
- در صورت تمایل، فایل خروجی را با استفاده از متد () shutil.move در مسیر محلی ذخیره کنید
مثال کد زیر نحوه تبدیل فایل DOCX به سند PDF و دانلود مستقیم آن را با استفاده از REST API در پایتون نشان می دهد. API باید فایل PDF تبدیل شده را در پاسخ بازگرداند. لطفاً برای آپلود فایل مراحل ذکر شده قبلی را دنبال کنید.
# نمونه های API لازم را ایجاد کنید
convert_api = groupdocs_conversion_cloud.تبدیلApi.from_keys(client_id, client_secret)
# تنظیمات تبدیل را تعریف کنید
settings = groupdocs_conversion_cloud.تبدیلSettings()
settings.file_path = "sample.docx"
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\\")
آنلاین را امتحان کنید
لطفاً ابزار آنلاین رایگان تبدیل DOCX به PDF زیر را که با استفاده از API بالا ایجاد شده است، امتحان کنید. https://products.groupdocs.app/conversion/docx-to-pdf
نتیجه
در این مقاله با نحوه تبدیل اسناد Word به فایل های PDF در فضای ابری آشنا شده اید. همچنین نحوه تبدیل صفحات خاص یا طیف وسیعی از صفحات از یک DOCX به PDF را با استفاده از پایتون مشاهده کرده اید. در این مقاله همچنین نحوه آپلود برنامه‌ای فایل DOCX بر روی ابر و سپس دانلود فایل PDF تبدیل شده از ابر توضیح داده شده است. علاوه بر این، می‌توانید با استفاده از مستندات درباره GroupDocs.Conversion Cloud API اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کنید و با آن‌ها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در [تالار] تماس حاصل فرمایید18.