インストール

パッケージは、availablePyPI にあり、経由でインストールできますpip次のコマンドを実行します。

pip install groupdocs-viewer-cloud

要件

• Python 2.7 または 3.4+
• pip パッケージマネージャー
• GroupDocs クラウド認証情報 —Client ID and Client Secretダッシュボードから

依存関係

SDK は次のパッケージを自動的にインストールします。

ドキュメント レンダリング用の Python クラウド REST API

GroupDocs.Viewer Cloud SDK for Pythonは、Word、Excel、PDF、CAD、電子メールなどの 190 以上の形式をサポートする強力なドキュメント レンダリング ソリューションを提供します。開発者は、元のドキュメントの構造とレイアウトを維持したまま、ドキュメントを HTML、PDF、および画像形式に簡単に変換してレンダリングできます。ストリーミング出力、カスタム ビュー オプション、マルチページ レンダリング、さまざまなファイル タイプのサポートなどの高度な機能を備えた GroupDocs.Viewer Cloud API は、あらゆる Python Web アプリ、スクリプト、または自動化ワークフローでのドキュメント表示のニーズにシームレスに統合します。無料でサインアップして、この堅牢なクラウドベース API の柔軟性と機能の活用を開始してください。

基本的な使い方

Simple Viewer Setup - 最小限の構成で GroupDocs.Viewer を迅速にセットアップするためのガイド。
クラウドからドキュメントをロード - クラウド ストレージからドキュメントを直接ロードして表示する手順。
カスタム ビュー オプション - ズーム、レイアウト、ナビゲーションなどのビューアー設定をカスタマイズする手順。
サポートされているファイル形式 - 変換せずに表示できる、サポートされているファイル形式の詳細なリスト。

HTML ビューア

ドキュメントを HTML に変換 - ブラウザベースでシームレスに表示できるように、ドキュメントを HTML 形式に変換するプロセス。
ストリーム HTML 出力 - リアルタイムでドキュメントをレンダリングするための HTML コンテンツのストリーミングに関するガイド。
HTML でのドキュメント構造の保持 - HTML への変換時に元のレイアウトと構造を維持するための手順。
カスタム HTML 表示オプション - スタイルやフォントなど、HTML で表示されるドキュメントの外観をカスタマイズする機能。

画像ビューア

ドキュメントを画像に変換 - ドキュメントを表示できるように PNG や JPEG などの画像形式に変換する手順。
ストリーム画像出力 - ドキュメント ビューアからのストリーミング画像形式のガイド。
画像解像度のカスタマイズ - ドキュメントを画像として表示するときに特定の画像解像度を設定するオプション。
複数ページのドキュメント画像のレンダリング - 複数ページのドキュメントを個別の画像としてレンダリングする手順。

PDF ビューア

ドキュメントを PDF に変換 - サポートされているドキュメント形式を PDF に変換して表示します。
ストリーム PDF 出力 - ブラウザーまたはアプリケーションでの表示を最適化するために PDF コンテンツをストリームするためのガイド。
PDF ビューアの埋め込み - カスタマイズ可能な PDF ビューアをアプリケーションに埋め込む手順。
PDF ビューアのサポート - PDF ドキュメントを表示および操作するための機能。

ドキュメントをレンダリングする

ドキュメントを HTML、画像、または PDF にレンダリング - ドキュメントを表示するために HTML、画像、または PDF 形式にレンダリングするオプション。
レンダリングされた出力をストリーミング - アプリケーションでリアルタイムにアクセスできるように、レンダリングされたドキュメント出力をストリーミングします。
複数ページのドキュメントのレンダリング - 複数ページのドキュメントを複数の HTML、画像、または PDF ファイルにレンダリングするためのサポート。

ドキュメント タイプ別のレンダリング オプション

ファイル タイプに特化したレンダリング - Word、Excel、PDF などのさまざまなドキュメント タイプに合わせたカスタム レンダリング オプション。
ドキュメントの機能を保持 - レイアウト、テキスト、書式設定などの元のドキュメントの機能がレンダリング中に保持されるようにします。

アーカイブ ファイルのレンダリング

ZIP、RAR、TAR ファイルのレンダリング - ZIP、RAR、TAR などのアーカイブ ファイル形式を表示可能なコンテンツに変換します。
特定のファイルを抽出してレンダリング - アーカイブ全体をダウンロードせずに、アーカイブから特定のファイルを抽出してレンダリングします。

CAD 図面のレンダリング

CAD 形式のレンダリング (DWG、DXF など) - 詳細な表示のために、DWG や DXF などの CAD ファイルを変換して表示します。
CAD レンダリング オプションのカスタマイズ - ズーム レベル、レイヤーの可視性、レイアウトなど、CAD レンダリングの特定のパラメーターを設定します。

電子メール メッセージのレンダリング

MSG、EML、および MHTML 形式のレンダリング - MSG、EML、MHTML などの形式で電子メール メッセージをビューア内で直接表示します。
添付ファイルの表示 - 簡単にアクセスできるように、電子メールの添付ファイルを自動的にレンダリングして表示します。

Lotus Notes データベース メッセージのレンダリング

NSF データベース メッセージのレンダリング - Lotus Notes (NSF) データベース メッセージをサポートされている形式に変換して表示します。
埋め込み要素へのアクセス - Lotus Notes データベース メッセージ内の埋め込み画像、ファイル、リンクをレンダリングして表示します。

MS プロジェクト ドキュメントのレンダリング

MS プロジェクト ファイル (MPP) のレンダリング - MS プロジェクト (MPP) ファイルを HTML、画像、または PDF に変換して、簡単に表示できるようにします。
プロジェクト データの表示 - MS Project ファイルからタスク、リソース、ガント チャート ビューをレンダリングします。

Outlook データ ファイルのレンダリング

PST および OST ファイルのレンダリング - Outlook の PST および OST データ ファイルを HTML、画像、または PDF 形式に変換して表示します。
電子メール、カレンダー、連絡先の表示 - Outlook データ ファイルから個々の電子メール メッセージ、カレンダー イベント、連絡先の詳細を表示します。

PDF ドキュメントのレンダリング

PDF を HTML、画像、またはその他の形式に変換 - Web ベースまたはアプリケーションで表示できるように、PDF ドキュメントを HTML、画像、またはその他のサポートされている形式にレンダリングします。
PDF 注釈とブックマーク - 注釈、ブックマーク、その他の埋め込み要素を含む PDF ドキュメントのレンダリングをサポートします。

スプレッドシートのレンダリング

Excel ファイルのレンダリング (XLS、XLSX) - XLS や XLSX などのスプレッドシート ファイルを HTML、画像、または PDF 形式に変換します。
グラフと数式を表示 - スプレッドシートのグラフ、数式、複雑なセル形式をレンダリングして正確に表示します。

テキスト ファイルのレンダリング

プレーン テキストおよび CSV ファイルのレンダリング - プレーン テキストおよび CSV ファイルを HTML、画像、または PDF に変換して表示を簡素化します。
テキストの書式を保持 - レンダリング中に元のテキストのレイアウトと書式を維持します。

Visio ドキュメントのレンダリング

Visio ファイルのレンダリング (VSD、VSDX) - Visio 図ファイルを HTML、画像、または PDF 形式に変換して表示します。
図とフローチャートの表示 - Visio ファイルから図、フローチャート、図形をレンダリングして、明確なプレゼンテーションを実現します。

ワープロ文書のレンダリング

Word ファイルのレンダリング (DOC、DOCX、ODT) - DOC、DOCX、ODT などの Word 処理ファイルを HTML、画像、または PDF 形式に変換します。
ドキュメント構造の保持 - ヘッダー、フッター、書式設定などのドキュメント構造を正確にレンダリングします。

ドキュメント ページの操作

ドキュメントからページを抽出 - ドキュメントから特定のページを抽出して個別にレンダリングします。
ページ表示のカスタマイズ - ドキュメント表示のページネーションとページ表示設定を制御します。

ドキュメント ページのレンダリング

ページを HTML、画像、または PDF にレンダリング - 個々のドキュメント ページを HTML、画像、または PDF 形式に変換して表示します。
ページ出力のストリーミング - 個々のドキュメント ページをストリーミングして、読み込み時間を短縮し、リアルタイムで表示します。

HTML と SVG の縮小

HTML コンテンツの縮小 - ページの読み込みを高速化するために、レンダリングされる HTML コンテンツのサイズを縮小します。
SVG 出力の最適化 - SVG 出力を縮小および最適化して、品質を損なうことなくパフォーマンスを向上させます。

ドキュメントをレスポンシブ HTML にレンダリングする

レスポンシブ HTML に変換 - ドキュメントを、さまざまな画面サイズやデバイスに適応するレスポンシブ HTML としてレンダリングします。
モバイル フレンドリーな表示 - レスポンシブ HTML レンダリングを使用して、ドキュメントがモバイルおよびタブレット デバイス向けに最適化されていることを確認します。

添付ファイルの操作

添付ファイルの抽出とレンダリング - ドキュメントまたは電子メール メッセージから添付ファイルを抽出してレンダリングし、簡単に表示できるようにします。
添付ファイルの種類の表示 - 画像、ドキュメント、アーカイブなどのさまざまな添付ファイルの種類の表示をサポートします。

ライセンスと認証

評価モード - 試用中にウォーターマーク付きのドキュメントをレンダリングします。
安全な認証 - 安全な API アクセスにはクライアント ID とクライアント シークレットを使用します。
MIT ライセンス - Python SDK は、以下に基づいてライセンスされています。MIT License.

サポートされているドキュメント形式

GroupDocs.Viewer Cloud は、次のカテゴリにわたる 190 以上のファイル形式をサポートしています。

• ワードプロセッサ: DOC、DOCX、DOCM、DOT、DOTX、DOTM、RTF、TXT、ODT、OTT
• スプレッドシート: XLS、XLSX、XLSB、XLSM、CSV、ODS、OTS、TSV
• プレゼンテーション: PPT、PPTX、PPTM、PPS、PPSX、PPSM、ODP、OTP、POTX、POTM
• PDF とページ レイアウト: PDF、XPS、TEX
• 画像: BMP、GIF、JPEG、PNG、TIFF、SVG、PSD、WEBP、ICO、EMF、WMF など
• CAD と図: DWG、DXF、DWF、DGN、IFC、STL; VSD、VSDX、VSS、VST、および関連する Visio 形式
• 電子メールと Outlook: MSG、EML、EMLX、MHT、PST、OST
• Web: HTML、HTM、MHT、MHTML
• アーカイブ: ZIP、RAR、TAR、およびその他のアーカイブ形式
• プロジェクト管理: MPP、MPT
• 電子書籍: EPUB、MOBI
• メモ: ONE (Microsoft OneNote)
• Lotus Notes: NSF データベース メッセージ

サポートされているすべての形式は、HTML、PNG/JPG、または PDF としてレンダリングできます。完全な形式マトリックスについては、documentation.

クイックスタート

API 認証情報を取得する

GroupDocs.Viewer Cloud を使用するには、次の URL でサインアップしてください。GroupDocs.Cloud Dashboardクライアント ID と クライアント シークレット を取得します。

API を初期化する

GroupDocs.Viewer Cloud SDK for 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")

このクイック スタート ガイドを使用すると、Python アプリケーションで GroupDocs.Viewer Cloud を使用してドキュメントのレンダリングを開始する準備が整います。詳細については、次のサイトを参照してください。documentation.

サポートされているファイル形式を取得する

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 としてレンダリングする

この例では、GroupDocs.Viewer Cloud API を使用して Word ドキュメントを PDF 形式にレンダリングする方法を示します。

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 としてレンダリングする

このコード サンプルは、GroupDocs.Viewer Cloud API を使用して Excel スプレッドシートを 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.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 文書をレンダリングする

出力 HTML の追跡された変更を含む Word ドキュメントをレンダリングします。

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リポジトリには、以下をカバーするすぐに実行できるサンプルが含まれています。

サンプルの実行方法

1. クローンを作成するか、ダウンロードします。samples repository2.Examplesディレクトリ 3.編集RunExamples.pyそしてあなたの設定をclient_idそしてclient_secret4. 走るpip install groupdocs-viewer-cloud -U5. 実行python RunExamples.py

詳細については、次のサイトをご覧ください。Getting Started.

タグ

Document Rendering API | Python Cloud API | GroupDocs.Viewer Cloud | REST API | HTML Rendering | PDF Conversion | Image Rendering | Document Viewing | Multi-Page Rendering | Document Streaming | CAD Rendering | E-Mail Message Rendering | Visio Rendering | MS Project Rendering | Outlook Data Rendering | Spreadsheet Rendering | Word Processing Rendering | Custom View Options | Responsive HTML | Attachment Rendering | Secure API Access | Cloud Storage Integration