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.
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-viewer-cloud
Требования
Зависимости
SDK автоматически устанавливает следующие пакеты:
| Пакет | Ограничение |
|---|
| urllib3 | >= 1.15 |
| six | >= 1.10 |
| certifi | — |
| python-dateutil | — |
Быстрый старт
Получите учетные данные API
Чтобы использовать GroupDocs.Viewer Cloud, зарегистрируйтесь на GroupDocs.Cloud Dashboard и получите свой Идентификатор клиента и Секрет клиента.
Инициализируйте API
Используйте следующий код, чтобы начать использовать Cloud SDK GroupDocs.Viewer для Python:
import groupdocs_viewer_cloud
# Get your ClientId and ClientSecret at https://dashboard.groupdocs.cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"
# Create API configuration
configuration = groupdocs_viewer_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
# Create instance of the View API
view_api = groupdocs_viewer_cloud.ViewApi.from_config(configuration)
Преобразовать документ в HTML
После инициализации используйте этот базовый пример для рендеринга документа из облачного хранилища:
import groupdocs_viewer_cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"
view_api = groupdocs_viewer_cloud.ViewApi.from_keys(client_id, client_secret)
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
view_options.view_format = "HTML"
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)
print("Document rendered: " + str(len(response.pages)) + " pages")
Благодаря этому краткому руководству вы можете приступить к рендерингу документов с помощью GroupDocs.Viewer Cloud в своих приложениях Python. Для получения более подробной информации посетите документацию.
Получить поддерживаемые форматы файлов
Получите полный список поддерживаемых форматов файлов, доступных через Viewer API.
import groupdocs_viewer_cloud
info_api = groupdocs_viewer_cloud.InfoApi.from_keys("YourClientId", "YourClientSecret")
try:
response = info_api.get_supported_file_formats()
print("Supported file-formats:")
for fmt in response.formats:
print("{0} ({1})".format(fmt.file_format, fmt.extension))
except groupdocs_viewer_cloud.ApiException as e:
print("Exception when calling get_supported_file_formats: {0}".format(e.message))
Отобразить документ в формате PDF
В этом примере показано, как преобразовать документ Word в формат PDF с помощью GroupDocs.Viewer Cloud API.
import groupdocs_viewer_cloud
view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
view_options.view_format = "PDF"
view_options.render_options = groupdocs_viewer_cloud.PdfOptions()
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)
print("Document rendered to PDF: " + response.file.path)
Отобразить электронную таблицу как HTML
Этот пример кода преобразует электронную таблицу Excel в HTML с помощью GroupDocs.Viewer Cloud API.
import groupdocs_viewer_cloud
view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.xlsx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)
print("Spreadsheet rendered to HTML: " + str(len(response.pages)) + " pages")
Рендеринг документа с адаптивным HTML-макетом
Отобразите документ в виде адаптивного HTML-кода, который адаптируется к различным размерам экрана и устройствам.
import groupdocs_viewer_cloud
view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
view_options.render_options.is_responsive = True
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)
print("Responsive HTML rendered: " + str(len(response.pages)) + " pages")
Рендеринг выбранных страниц
Конвертируйте только определенные страницы документа, экономя время обработки, когда требуется только часть документа.
import groupdocs_viewer_cloud
view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
view_options.render_options.pages_to_render = [2, 3]
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)
print("Selected pages rendered: " + str(len(response.pages)) + " pages")
Рендеринг документа Word с отслеживаемыми изменениями
Отобразите документ Word, включая отслеживаемые изменения в выходном HTML.
import groupdocs_viewer_cloud
view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/with_tracked_changes.docx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
view_options.render_options.word_processing_options = groupdocs_viewer_cloud.WordProcessingOptions()
view_options.render_options.word_processing_options.render_tracked_changes = True
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)
print("Tracked changes rendered: " + str(len(response.pages)) + " pages")
Получить информацию о документе
Получите метаданные документа, такие как количество страниц, перед рендерингом.
import groupdocs_viewer_cloud
info_api = groupdocs_viewer_cloud.InfoApi.from_keys("YourClientId", "YourClientSecret")
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
request = groupdocs_viewer_cloud.GetInfoRequest(view_options)
result = info_api.get_info(request)
print("Document pages: " + str(len(result.pages)))
Конвертируйте и загружайте без облачного хранилища
Отрисуйте локальный документ напрямую и получите выходной файл без предварительной загрузки в облачное хранилище.
import groupdocs_viewer_cloud
view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")
with open("sample.docx", "rb") as file:
request = groupdocs_viewer_cloud.ConvertAndDownloadRequest("jpg", file)
output_path = view_api.convert_and_download(request)
print("Convert and download completed: " + output_path)
Примеры проектов на GitHub
Репозиторий GroupDocs.Viewer Cloud Python Samples включает готовые примеры, охватывающие:
| Категория | Примеры |
|---|
| Basic Usage | Supported formats, document info, attachments, convert and download |
| HTML Viewer | Responsive layout, minify HTML, exclude fonts, optimize for printing |
| Image Viewer | Adjust image size, JPG quality, text overlay, text coordinates |
| PDF Viewer | Protect PDF, adjust JPG quality |
| Common Rendering Options | Watermarks, selected pages, consecutive pages, comments, notes, custom fonts |
| Loading Options | Protected documents, specify encoding |
| Rendering by File Type | Archive, CAD, email, Outlook, PDF, spreadsheet, Visio, Word, Lotus Notes, MS Project, text |
Как запустить примеры
- Клонируйте или загрузите репозиторий образцов.
- Перейдите в каталог «Примеры».
- Отредактируйте RunExamples.py и установите client_id и client_secret.
- Запустите
pip install groupdocs-viewer-cloud -U - Выполните
python RunExamples.py
Для получения более подробной информации посетите Начало работы.
Теги
API рендеринга документов | Python Cloud API | GroupDocs.Viewer Cloud | REST API | HTML-рендеринг | Преобразование PDF | Рендеринг изображения | Просмотр документа | Многостраничный рендеринг | Потоковая передача документов | CAD-рендеринг | Визуализация сообщений электронной почты | Visio Rendering | Рендеринг MS Project | Рендеринг данных Outlook | Рендеринг электронных таблиц | Рендеринг текстовой обработки | Параметры пользовательского просмотра | Адаптивный HTML | Визуализация вложений | Безопасный доступ к API | Интеграция облачного хранилища