Перетворюйте документи Word у PDF за допомогою REST API у Python.

Обмін документами Word у форматі PDF є загальноприйнятою практикою, оскільки PDF є широко використовуваним форматом обміну документами в галузі. Ви можете легко конвертувати Word у PDF за допомогою вбудованих функцій Microsoft Office, але вам може знадобитися конвертувати документи Word (DOC або DOCX) у PDF програмним шляхом. У цій статті ви дізнаєтесь, як конвертувати документи Word у PDF за допомогою REST API у Python.

У цій статті будуть розглянуті такі теми:

REST API перетворення Word у PDF і Python SDK

Для перетворення DOCX у PDF ми будемо використовувати API Python SDK GroupDocs.Conversion Cloud. Це незалежне від платформи рішення для конвертації документів/зображень і не залежить від жодного інструменту чи програмного забезпечення. Це дає змогу швидко й надійно конвертувати зображення й документи будь-якого підтримуваного формату файлів у будь-який потрібний формат.

Ви можете встановити GroupDocs.Conversion Cloud у свою програму Python за допомогою такої команди в консолі:

pip install groupdocs_conversion_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 = ""

Перетворюйте документи Word у PDF за допомогою REST API у Python

Ви можете програмно конвертувати документи Word у формат PDF у хмарі, виконавши прості дії, наведені нижче:

  1. Завантажте файл DOCX у хмару
  2. Перетворіть DOCX на PDF за допомогою Python
  3. Завантажити конвертований 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 за допомогою Python

Ви можете легко конвертувати документ DOCX у PDF програмним шляхом, виконавши наведені нижче дії.

  • По-перше, створіть екземпляр ConvertApi.
  • Тепер створіть екземпляр ConvertSettings.
  • Потім укажіть шлях до вхідного файлу DOCX.
  • Встановіть формат «pdf».
  • Укажіть шлях до вихідного файлу.
  • Тепер створіть ConvertDocumentRequest за допомогою ConvertSettings.
  • Нарешті, конвертуйте DOCX, викликавши метод convert\document() за допомогою ConvertDocumentRequest.

У наведеному нижче прикладі коду показано, як конвертувати DOCX у PDF за допомогою REST API у Python.

# Створіть екземпляр 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)
Перетворюйте документи Word у PDF за допомогою REST API у Python

Перетворюйте документи Word у PDF за допомогою REST API у Python.

Завантажте конвертований файл

Наведений вище зразок коду збереже перетворений 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
  • Потім установіть різні параметри перетворення, такі як відображення\документ\заголовок, поля (верхнє, ліве, праве, нижнє) тощо.
  • Тепер створіть ConvertDocumentRequest за допомогою ConvertSettings
  • Нарешті, перетворіть DOCX, викликавши метод convert\document() за допомогою ConvertDocumentRequest

У наведеному нижче прикладі коду показано, як перетворити документ 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 на Python

Ви можете програмно конвертувати ряд сторінок із документа Word у файл PDF, виконавши наведені нижче дії.

  • По-перше, створіть екземпляр ConvertApi
  • Тепер створіть екземпляр ConvertSettings
  • Потім укажіть шлях до вхідного файлу DOCX
  • Призначте формату «pdf».
  • Укажіть шлях до вихідного файлу
  • Тепер створіть екземпляр PdfConvertOptions
  • Потім укажіть діапазон сторінок для конвертації з номера початкової сторінки та загальної кількості сторінок для конвертації
  • Тепер призначте PdfConvertOptions для ConvertSettings
  • Потім створіть ConvertDocumentRequest за допомогою ConvertSettings
  • Нарешті, конвертуйте, викликавши метод convert\document() за допомогою ConvertDocumentRequest

У наведеному нижче прикладі коду показано, як конвертувати ряд сторінок із DOCX у PDF за допомогою REST API у Python. Будь ласка, виконайте кроки, згадані раніше, щоб завантажити та завантажити файл.

# Створіть екземпляр 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 на Python

Ви можете програмно перетворити певні сторінки документа Word у файл PDF, виконавши наведені нижче дії.

  • По-перше, створіть екземпляр ConvertApi
  • Тепер створіть екземпляр ConvertSettings
  • Потім укажіть шлях до вхідного файлу DOCX
  • Призначте формату «pdf».
  • Укажіть шлях до вихідного файлу
  • Тепер створіть екземпляр PdfConvertOptions
  • Потім укажіть конкретні номери сторінок у масиві, розділеному комами, для перетворення
  • Тепер призначте PdfConvertOptions для ConvertSettings
  • Потім створіть ConvertDocumentRequest за допомогою ConvertSettings
  • Нарешті, конвертуйте, викликавши метод convert\cocument() за допомогою ConvertDocumentRequest

У наведеному нижче прикладі коду показано, як конвертувати певні сторінки документа Word у PDF за допомогою REST API у Python. Будь ласка, виконайте кроки, згадані раніше, щоб завантажити та завантажити файл.

# Створіть екземпляр 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 із водяним знаком за допомогою Python

Ви можете конвертувати документи Word у PDF-документи та додавати водяні знаки до конвертованих документів програмним шляхом, виконавши наведені нижче дії.

  • По-перше, створіть екземпляр ConvertApi
  • Тепер створіть екземпляр ConvertSettings
  • Потім укажіть шлях до вхідного файлу DOCX
  • Призначте формату «pdf».
  • Укажіть шлях до вихідного файлу
  • Тепер створіть екземпляр WatermarkOptions
  • Потім установіть текст водяного знака, колір, ширину, висоту, ліворуч, зверху тощо.
  • Тепер визначте PdfConvertOptions і призначте WatermarkOptions
  • Тепер створіть ConvertDocumentRequest за допомогою ConvertSettings
  • Нарешті, перетворіть DOCX, викликавши метод convert\document() за допомогою ConvertDocumentRequest

У наведеному нижче прикладі коду показано, як перетворити документ Word на PDF-документ і додати водяний знак до перетвореного PDF-документа за допомогою REST API у Python. Будь ласка, виконайте кроки, згадані раніше, щоб завантажити та завантажити файли.

# Ініціалізація 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 із водяним знаком за допомогою Python.

Перетворення Word у PDF із водяним знаком за допомогою Python.

Перетворення DOCX у PDF без використання хмарного сховища

Ви можете конвертувати документ Word у PDF без використання хмарного сховища, передавши його в тілі запиту та отримавши вихідний файл у відповідь API. Виконайте наведені нижче кроки, щоб конвертувати 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 і завантажити його безпосередньо за допомогою API 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.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 за допомогою Python. У цій статті також пояснюється, як програмно завантажити файл DOCX у хмару, а потім завантажити перетворений PDF-файл із хмари. Крім того, ви можете дізнатися більше про GroupDocs.Conversion Cloud API за допомогою документації. Ми також надаємо розділ API Reference, який дозволяє візуалізувати наші API та взаємодіяти з ними безпосередньо через браузер. У разі будь-яких неясностей зв’яжіться з нами на форумі.

Дивись також