Установка

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

pip install groupdocs-merger-cloud

Требования

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

Зависимости

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

Объединение документов и страниц Python Cloud REST API

GroupDocs.Merger Cloud SDK для Python позволяет разработчикам интегрировать расширенные функции слияния документов и манипулирования страницами в свои веб-приложения, сценарии и рабочие процессы автоматизации Python. Поддерживая более 40 форматов файлов, этот REST API позволяет плавно объединять, разделять и реорганизовывать страницы документов, включая PDF-файлы, документы Word, электронные таблицы Excel и многое другое. Функции безопасности включают защиту документов паролем, а дополнительные операции с файлами и папками упрощают управление облачным хранилищем. Независимо от того, работаете ли вы с кросс-форматными документами или выполняете сложные манипуляции со страницами, GroupDocs.Merger предоставляет надежные инструменты для безопасной и эффективной обработки документов на веб-платформах, настольных и мобильных платформах.

Объединить документы

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

Разделение и манипулирование страницами

Разделить документы - Разделите исходный документ на несколько отдельных файлов.
Переместить страницы - Перемещение страниц документа внутри файла.
Поворот страниц - Поворачивайте страницы документа, чтобы изменить их ориентацию.
Удалить страницы - Удалите ненужные страницы из документа.
Поменять страницы - Поменяйте местами страницы внутри документа.
Извлечь страницы - Извлеките определенные страницы из документа в новый файл.
Изменить ориентацию страницы - Отрегулируйте ориентацию страницы в поддерживаемых типах документов.

Безопасность и защита документов

Установить пароль документа - Защитите документы, установив пароль.
Удалить пароль документа - Удалите существующие пароли из защищенных документов.
Обновить пароль документа - Измените пароль защищенного документа.
Проверьте защиту паролем - Проверьте, защищен ли документ паролем.

Операции с файлами

Загрузить файлы в облако - Загружайте файлы в облачное хранилище через API.
Загрузить файлы из облака - Загружайте файлы из облачного хранилища в локальные системы.
Копировать файлы - Копируйте файлы из облачного хранилища в разные места.
Переместить файлы - Перемещайте файлы между папками в облачном хранилище.
Удалить файлы - Удалите определенные файлы из облачного хранилища.

Операции с папками

Создать папку - Создайте новые папки в облачном хранилище.
Копировать папку - Дублирование папок в облачном хранилище.
Переместить папку - Перемещайте папки между каталогами в облачном хранилище.
Удалить папку - Удалите целые папки из облачного хранилища.

Лицензирование и аутентификация

Режим оценки - Попробуйте API с помощью бесплатной пробной учетной записи.
Безопасная аутентификация - Используйте идентификатор клиента и секрет клиента для безопасного доступа к API.
Лицензия MIT - Python SDK лицензируется по Лицензии MIT.

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

GroupDocs.Merger Cloud поддерживает более 40 форматов файлов с возможностями объединения, разделения и манипулирования страницами:

• Обработка текста: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, HTML, MHT, MHTML
• PDF и макет страницы: PDF, XPS, TEX, EPUB
• Презентации: PPT, PPTX, PPS, PPSX, ODP, OTP, POTX, POTM, PPSM, PPTM
• Таблицы: XLS, XLSX, XLSB, XLSM, XLT, XLTX, XLTM, ODS, CSV, TSV
• Диаграммы: VSDX, VSDM, VSSX, VSSM, VSTX, VSTM, VDX, VSX, VTX
• Примечания: ONE (Microsoft OneNote)
• Текст: TXT, ERR

Поддерживаемые операции зависят от формата. Межформатное слияние с PDF/XPS и DOC/DOCX доступно для многих типов. Полную матрицу форматов см. в документации.

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

Получите учетные данные 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 включает готовые примеры, охватывающие:

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

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

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

Теги

Document Merging API | Python Cloud API | GroupDocs.Merger Cloud | REST API | Манипулирование страницами | Безопасность документа | Защита паролем | Интеграция облачного хранилища | Операции с файлами | Операции с папками | Разделение документа | Слияние PDF | Кросс-форматное слияние | Слияние документов Word | Слияние файлов Excel | Слияние презентаций | Реорганизация документа | Безопасный доступ к API | Объединение документов | API манипулирования документами | Объединить несколько форматов | Кроссплатформенный API