Облачный 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-merger-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.Merger Cloud, зарегистрируйтесь на GroupDocs.Cloud Dashboard и получите свой Идентификатор клиента и Секрет клиента.

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

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

import groupdocs_merger_cloud

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

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

# Create instance of the Document API
document_api = groupdocs_merger_cloud.DocumentApi.from_config(configuration)

Объединить несколько документов

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

import groupdocs_merger_cloud

client_id = "YourClientId"
client_secret = "YourClientSecret"

document_api = groupdocs_merger_cloud.DocumentApi.from_keys(client_id, client_secret)

item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/four-pages.docx")

item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/one-page.docx")

options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "Output/joined.docx"

result = document_api.join(groupdocs_merger_cloud.JoinRequest(options))

print("Output file path = " + result.path)

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

Получить поддерживаемые форматы файлов

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

import groupdocs_merger_cloud

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

result = info_api.get_supported_file_formats()

for fmt in result.formats:
    print(fmt.file_format)

Объединение страниц из разных документов

Объединяйте определенные страницы из нескольких исходных документов в один выходной файл с поддержкой диапазонов страниц и фильтров.

import groupdocs_merger_cloud

document_api = groupdocs_merger_cloud.DocumentApi.from_keys("YourClientId", "YourClientSecret")

item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/sample-10-pages.docx")
item1.pages = [3, 6, 8]

item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/four-pages.docx")
item2.start_page_number = 1
item2.end_page_number = 4
item2.range_mode = "OddPages"

options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "Output/joined-pages.docx"

result = document_api.join(groupdocs_merger_cloud.JoinRequest(options))

print("Output file path = " + result.path)

Объединение документов разных форматов в PDF

Объединяйте документы разных форматов (например, PDF-файлы, защищенные паролем, и DOCX) в один PDF-файл.

import groupdocs_merger_cloud

document_api = groupdocs_merger_cloud.DocumentApi.from_keys("YourClientId", "YourClientSecret")

item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo(
    "Pdf/one-page-password.pdf", None, None, "password"
)

item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/one-page.docx")

options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "Output/joined.pdf"

result = document_api.join(groupdocs_merger_cloud.JoinRequest(options))

print("Output file path = " + result.path)

Разделить документ на отдельные страницы

Разделите документ на отдельные файлы, указав точные номера страниц.

import groupdocs_merger_cloud

document_api = groupdocs_merger_cloud.DocumentApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_merger_cloud.SplitOptions()
options.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/sample-10-pages.docx")
options.output_path = "Output/split-document"
options.pages = [1, 3]
options.mode = "Pages"

result = document_api.split(groupdocs_merger_cloud.SplitRequest(options))

print("Documents count = " + str(len(result.documents)))

Извлечение страниц по номерам

Извлеките определенные страницы из документа в новый файл.

import groupdocs_merger_cloud

pages_api = groupdocs_merger_cloud.PagesApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_merger_cloud.ExtractOptions()
options.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/sample-10-pages.docx")
options.output_path = "Output/extract-pages-by-numbers.docx"
options.pages = [2, 4, 7]

result = pages_api.extract(groupdocs_merger_cloud.ExtractRequest(options))

print("Output file path = " + result.path)

Поворот страниц документа

Поворачивайте выбранные страницы PDF-документа, чтобы изменить их ориентацию.

import groupdocs_merger_cloud

pages_api = groupdocs_merger_cloud.PagesApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_merger_cloud.RotateOptions()
options.file_info = groupdocs_merger_cloud.FileInfo("Pdf/ten-pages.pdf")
options.output_path = "Output/rotate-pages.pdf"
options.pages = [2, 4]
options.mode = "Rotate90"

result = pages_api.rotate(groupdocs_merger_cloud.RotateRequest(options))

print("Output file path = " + result.path)

Добавить пароль в документ

Защитите документ, добавив защиту паролем.

import groupdocs_merger_cloud

security_api = groupdocs_merger_cloud.SecurityApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_merger_cloud.Options()
options.file_info = groupdocs_merger_cloud.FileInfo(
    "WordProcessing/one-page.docx", None, None, "password"
)
options.output_path = "Output/add-password.docx"

result = security_api.add_password(groupdocs_merger_cloud.AddPasswordRequest(options))

print("Output file path = " + result.path)

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

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

Категория	Примеры
Info	Supported file types, document information
Document Operations	Join multiple documents, cross-format join, join pages, join images, split documents, preview, import attachment
Pages Operations	Extract pages, move pages, remove pages, rotate pages, swap pages, change orientation
Security Operations	Add, remove, update password; check password protection

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

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

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