ドキュメント比較クラウド 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.

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

要件

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

依存関係

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

パッケージ	制約
urllib3	>= 1.15
six	>= 1.10
certifi	—
python-dateutil	—

ドキュメントの比較と改訂 Python クラウド REST API

GroupDocs.Comparison Cloud SDK for Pythonは、開発者がドキュメント比較機能を Python Web アプリ、スクリプト、自動化ワークフローに統合できるように設計された強力なクラウド REST API です。 90 を超えるファイル形式をサポートするこの API を使用すると、フォルダー全体の比較、ドキュメントの改訂の承認または拒否、ページプレビューによる変更の視覚化が可能になります。きめ細かい変更管理、スタイルのカスタマイズ、複数ドキュメントのサポートなどの機能により、開発者は一括ファイル比較を効率的に自動化できます。追加機能には、パスワードで保護されたドキュメントの比較、ソースコードファイルのマージ、詳細な変更座標の抽出などがあります。このツールは、共同作業環境、法的文書レビュー、バージョン管理システムに最適です。

フォルダーとドキュメントの比較

フォルダー全体を比較 - 相違点を自動検出して、ディレクトリ全体の内容を比較します。
変更されたアイテムをフィルタリング - 結果を TXT または HTML 形式で保存し、変更されたアイテムのみを表示します。
一括ファイル比較 - Python アプリケーション内で一括ファイル比較を効率的に自動化します。

文書改訂管理

DOCX のリビジョンを承認または拒否 - Word DOCX ファイルのリビジョンをプログラムで承認または拒否します。
リビジョンリストの抽出 - すべてのリビジョンを取得し、必要な変更を適用し、その他を拒否します。
バージョン管理 - ドキュメントの編集とバージョン管理を完全に制御できます。

ドキュメントページのプレビューの生成

ページプレビューの生成 - 比較結果を保存する前に、高品質のプレビュー画像を作成します。
カスタムプレビュー形式 - 形式 (PNG、JPG、BMP) を指定し、カスタム寸法を選択します。
ビジュアルレビューワークフロー - ビジュアルコンテンツ管理を必要とするアプリケーションにドキュメントプレビューを統合します。

変更管理とレビュー

検出された変更を受け入れるか拒否する - ドキュメントの変更を細かい精度で制御します。
改訂を表示し、変更を追跡 - Word スタイルの変更追跡を使用して相違点を強調表示します。
変更の作成者を設定 - 説明責任を強化するために、検出された変更に作成者を割り当てます。

カスタマイズと柔軟性

変更スタイルをカスタマイズ - フォント、色、テキストスタイル (太字、斜体、取り消し線) を制御します。
比較感度を調整 - 0 ～ 100 の感度設定で速度と精度のバランスをとります。

マルチドキュメントのサポート

複数のドキュメントを比較 - 3 つ以上のドキュメントを同時に比較します。
パスワードで保護されたドキュメント - パスワードで保護されたソースファイルとターゲットファイルを比較します。
ソースコードファイルのマージ - 変更管理を使用して、複数のバージョンのソースコードファイルを比較およびマージします。

詳細な変更分析

変更座標の取得 - ドキュメント内の変更の正確な位置を取得します。
変更リストの取得 - 変更タイプ、ページ番号、影響を受けるテキストを含む詳細なリストを受け取ります。
ソーステキストとターゲットテキストを抽出 - 検出された変更ごとに、元のテキストと変更されたテキストを抽出します。

保存とメタデータの制御

保存時にドキュメントのメタデータを設定 - 出力ドキュメントの作成者、タイトル、または組織を制御します。
出力ドキュメントにパスワードを設定 - 結果のドキュメントにパスワード保護を適用します。

ライセンスと認証

評価モード - 無料試用アカウントで API を試してください。
安全な認証 - 安全な API アクセスにはクライアント ID とクライアントシークレットを使用します。
MIT ライセンス - Python SDK は、以下に基づいてライセンスされています。MIT License.

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

GroupDocs.Comparison Cloud は、90 以上のファイル形式をサポートし、比較機能と自動検出機能を備えています。

ワードプロセッサ: DOC、DOCM、DOCX、DOT、DOTM、DOTX、ODT、OTT、RTF
スプレッドシート: XLS、XLT、XLSX、XLTM、XLSB、XLSM、ODS、CSV
プレゼンテーション: POT、POTX、PPS、PPSX、PPTX、PPT、ODP、OTP
図: VSDX、VSD、VSS、VST、VDX
メモ: ONE (Microsoft OneNote)
PDF とページレイアウト: PDF、MOBI、DJVU
画像: BMP、GIF、JPG/JPEG、PNG、DCM、DWG、DXF
電子メール: EML、EMLX、MSG
Web: HTML、MHT、MHTML
ソースコード: CS、JAVA、CPP、JS、PY、RB

サポートされる操作は形式によって異なります。完全な形式マトリックスについては、documentation.

クイックスタート

API 認証情報を取得する

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

API を初期化する

GroupDocs.Comparison Cloud SDK for Python の使用を開始するには、次のコードを使用します。

import groupdocs_comparison_cloud

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

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

# Create instance of the Compare API
compare_api = groupdocs_comparison_cloud.CompareApi.from_config(configuration)

2 つの文書を比較する

初期化したら、次の基本的な例を使用して Word 文書を比較し、結果を保存します。

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source.docx"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target.docx"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.docx"

response = compare_api.comparisons(groupdocs_comparison_cloud.ComparisonsRequest(options))

print("Output file link: " + response.href)

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

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

Comparison API を通じて利用可能な、サポートされているファイル形式の完全なリストを取得します。

import groupdocs_comparison_cloud

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

result = info_api.get_supported_file_formats()

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

PDF ドキュメントを比較する

2 つの PDF ドキュメントを比較し、追跡された変更を強調表示して結果を保存します。

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/pdf/source.pdf"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/pdf/target.pdf"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.pdf"

response = compare_api.comparisons(groupdocs_comparison_cloud.ComparisonsRequest(options))

print("Output file link: " + response.href)

パスワードで保護されたドキュメントを比較する

各ファイルの資格情報を指定して、パスワードで保護された 2 つの Word 文書を比較します。

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source_protected.docx"
source.password = "1231"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target_protected.docx"
target.password = "5784"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.docx"

response = compare_api.comparisons(groupdocs_comparison_cloud.ComparisonsRequest(options))

print("Output file link: " + response.href)

変更リストの取得

ソースドキュメントとターゲットドキュメント間で検出されたすべての変更の詳細なリストを取得します。

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source.docx"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target.docx"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.docx"

changes = compare_api.post_changes(groupdocs_comparison_cloud.PostChangesRequest(options))

print("Changes count: " + str(len(changes)))

変更を受け入れるか拒否する

ドキュメントを比較した後、個々の変更を承認または拒否し、更新された結果を保存します。

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source.docx"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target.docx"
options = groupdocs_comparison_cloud.UpdatesOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.docx"

changes = compare_api.post_changes(groupdocs_comparison_cloud.PostChangesRequest(options))

for change in changes:
    change.comparison_action = "Reject"
changes[0].comparison_action = "Accept"

options.changes = changes

response = compare_api.put_changes_document(groupdocs_comparison_cloud.PutChangesDocumentRequest(options))

print("Output file link: " + response.href)

オプションを使用して複数のドキュメントを比較

ソースドキュメントを複数のターゲットと比較し、挿入されたアイテムの外観をカスタマイズします。

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source.docx"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target.docx"
target1 = groupdocs_comparison_cloud.FileInfo()
target1.file_path = "target_files/word/target_1.docx"
target2 = groupdocs_comparison_cloud.FileInfo()
target2.file_path = "target_files/word/target_2.docx"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target, target1, target2]
options.output_path = "output/result.docx"
settings = groupdocs_comparison_cloud.Settings()
settings.inserted_items_style = groupdocs_comparison_cloud.ItemsStyle()
settings.inserted_items_style.font_color = "16711680"
options.settings = settings

response = compare_api.comparisons(groupdocs_comparison_cloud.ComparisonsRequest(options))

print("Output file link: " + response.href)

DOCX ドキュメントにリビジョンを適用する

Word 文書内の追跡されたリビジョンをプログラムで承認または拒否します。

import groupdocs_comparison_cloud

review_api = groupdocs_comparison_cloud.ReviewApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source_with_revs.docx"
options = groupdocs_comparison_cloud.ApplyRevisionsOptions()
options.source_file = source
options.output_path = "output/result.docx"

revisions = review_api.get_revisions(groupdocs_comparison_cloud.GetRevisionsRequest(source))

for revision in revisions:
    revision.action = "Accept"

options.revisions = revisions

response = review_api.apply_revisions(groupdocs_comparison_cloud.ApplyRevisionsRequest(options))

print("Output file link: " + response.href)

GitHub のサンプルプロジェクト

のGroupDocs.Comparison Cloud Python Samplesリポジトリには、以下をカバーするすぐに実行できるサンプルが含まれています。

カテゴリー	例
基本的な使い方	サポートされている形式、ドキュメント情報、ドキュメントの比較、PDF ドキュメントの比較、ドキュメントのプレビュー
高度な使用法 — 複数ドキュメントの比較	オプションを使用して複数のドキュメントを比較、複数の保護されたドキュメントを比較
高度な使用法 — 改訂版	リビジョンのリストを取得する、リビジョンを適用する、すべてのリビジョンを受け入れる、すべてのリビジョンを拒否する
高度な使用法 — 保存オプション	メタデータの設定、保存時のパスワードの設定
高度な使用法 — 変更制御	変更の承認または拒否、保護されたドキュメントの比較、機密性の比較、変更スタイルのカスタマイズ、変更座標の取得、変更リストの取得

サンプルの実行方法

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

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