Облачный API для преобразования документов

Просмотрите наши продукты

Are you looking for an evaluation version of a product?

If so you can download any of the below versions for testing. The product will function as normal except for an evaluation limitation. At the time of purchase we provide a license file via email that will allow the product to work in its full capacity. If you would also like an evaluation license to test without any restrictions for 30 days, please follow the directions provided here.

Are you having troubles in downloading?

If you experience errors, when you try to download a file, make sure your network policies (enforced by your company or ISP) allow downloading ZIP and/or MSI files.

Установка
Пакет доступен в PyPI, и его можно установить через pip, выполнив следующую команду:
pip install groupdocs-conversion-cloud

Требования

Python 2.7 или 3.4+
менеджер пакетов pip
Учетные данные GroupDocs Cloud — Client ID и Client Secret из панели управления

Зависимости

SDK автоматически устанавливает следующие пакеты:

Пакет	Ограничение
urllib3	>= 1.15
six	>= 1.10
certifi	—
python-dateutil	—

Быстрый старт

Получите учетные данные API

Чтобы использовать GroupDocs.Conversion Cloud, зарегистрируйтесь на GroupDocs.Cloud Dashboard и получите свой Идентификатор клиента и Секрет клиента.

Инициализируйте API

Используйте следующий код, чтобы начать использовать Cloud SDK GroupDocs.Conversion для Python:

import groupdocs_conversion_cloud

# Get your ClientId and ClientSecret at https://dashboard.groupdocs.cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"

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

# Create instance of the Convert API
convert_api = groupdocs_conversion_cloud.ConvertApi.from_config(configuration)

Преобразование документа (напрямую, без облачного хранилища)

После инициализации используйте этот базовый пример для преобразования локального документа и получения результата напрямую:

import groupdocs_conversion_cloud

client_id = "YourClientId"
client_secret = "YourClientSecret"

# Create instance of the API
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Prepare request: output format and local file path
request = groupdocs_conversion_cloud.ConvertDocumentDirectRequest("pdf", "input.docx")

# Convert and save the result
result = convert_api.convert_document_direct(request)

with open("output.pdf", "wb") as f:
    f.write(result)

Благодаря этому краткому руководству вы можете приступить к преобразованию документов с помощью GroupDocs.Conversion Cloud в своих приложениях Python. Для получения более подробной информации посетите документацию.

Конвертируйте документы с помощью облачного хранилища

В этом примере файл загружается в облачное хранилище GroupDocs, преобразуется и загружается результат — идеально подходит для рабочих процессов на стороне сервера, которые управляют файлами в облаке.

import groupdocs_conversion_cloud

client_id = "YourClientId"
client_secret = "YourClientSecret"

# Create instances of the APIs
file_api = groupdocs_conversion_cloud.FileApi.from_keys(client_id, client_secret)
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Upload file to cloud storage
file_api.upload_file(
    groupdocs_conversion_cloud.UploadFileRequest("myFile.docx", "myFile.docx")
)

# Prepare convert settings
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "myFile.docx"
settings.format = "pdf"
settings.output_path = "converted"

# Convert the document
result = convert_api.convert_document(
    groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
)

print("Document converted: " + result[0].url)

# Download the converted file
response = file_api.download_file(
    groupdocs_conversion_cloud.DownloadFileRequest("converted/myFile.pdf", None)
)

Преобразование документов между различными форматами Cloud API

Этот код позволяет разработчикам программно конвертировать документы в различные форматы с расширенными параметрами вывода PDF, исключая ручное преобразование. Он поддерживает более 50 форматов файлов, что делает его идеальным для разработчиков приложений, которым требуется поддержка нескольких форматов.

import groupdocs_conversion_cloud

configuration = groupdocs_conversion_cloud.Configuration("YourClientId", "YourClientSecret")
convert_api = groupdocs_conversion_cloud.ConvertApi.from_config(configuration)

# Prepare convert settings
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "WordProcessing/password-protected.docx"
settings.format = "pdf"
settings.output_path = "converted"

# Load options for password-protected source document
load_options = groupdocs_conversion_cloud.WordProcessingLoadOptions()
load_options.password = "password"

# PDF conversion options
convert_options = groupdocs_conversion_cloud.PdfConvertOptions()
convert_options.center_window = True
convert_options.compress_images = False
convert_options.display_doc_title = True
convert_options.dpi = 1024
convert_options.from_page = 1
convert_options.image_quality = 100
convert_options.password = "password"
convert_options.unembed_fonts = True

settings.load_options = load_options
settings.convert_options = convert_options

# Execute the conversion
result = convert_api.convert_document(
    groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
)

print("Document converted: " + result[0].url)

Преобразование определенных страниц API Document Cloud

Этот пример демонстрирует, как разработчики могут конвертировать только определенные страницы, экономя время обработки и уменьшая размеры файлов, когда требуется только часть документа.

import groupdocs_conversion_cloud

convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys("YourClientId", "YourClientSecret")

# Configure settings to convert specific pages (e.g., pages 1 and 3)
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "WordProcessing/four-pages.docx"
settings.format = "pdf"
settings.output_path = "converted/two-pages.pdf"

convert_options = groupdocs_conversion_cloud.PdfConvertOptions()
convert_options.pages = [1, 3]
settings.convert_options = convert_options

# Execute the conversion
result = convert_api.convert_document(
    groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
)

print("Document converted: " + result[0].url)

Получите поддерживаемые форматы конвертации

Получите полный список поддерживаемых преобразований исходного формата в целевой, доступных через API.

import groupdocs_conversion_cloud

info_api = groupdocs_conversion_cloud.InfoApi.from_keys("YourClientId", "YourClientSecret")

result = info_api.get_supported_conversion_types(
    groupdocs_conversion_cloud.GetSupportedConversionTypesRequest()
)

print("Formats count: " + str(len(result)))

Примеры проектов на GitHub

Репозиторий GroupDocs.Conversion Cloud Python Samples включает готовые примеры, охватывающие:

Категория	Примеры
Convert	PDF, HTML, image, presentation, spreadsheet, word processing; direct conversion; async conversion
Common Options	Watermarks, specific pages, consecutive pages, custom fonts
Load Options	CAD, CSV, email, HTML, OneNote, PDF, presentation, spreadsheet, text, word processing
Info	Supported conversions, document information

Как запустить примеры

Клонируйте или загрузите репозиторий образцов.
Отредактируйте «Examples/Common.py» и установите «client_id» и «client_secret».
Перейдите в каталог «Примеры».
Запустите pip install groupdocs-conversion-cloud -U
Выполните python RunExamples.py

Для получения более подробной информации посетите Начало работы.