PythonでPDFを結合する

PDF の分割と結合の操作は、通常、有料ソフトウェアで提供されており、ほとんどの無料の PDF ビューアーではこれらの機能は提供されていません。また、特定の PDF ドキュメントを結合する必要がある場合は、まず完全なライセンス サブスクリプションをインストールして構成し、購入する必要があります。PDF ファイルを結合するだけが必要な場合でも、完全なライセンス料金を支払う必要があります。これとは別に、PDF ファイルを結合する必要があるが、特定のプラットフォームでソフトウェアが利用できないというシナリオに遭遇する可能性もあります。したがって、このようなシナリオをすべて軽減するために、Aspose.PDF Cloud API を使用して PDF ファイルをオンラインで結合することをお勧めします。ソフトウェアのダウンロードやインストールは不要で、すべての操作をクラウドで実行できます。

Python での PDF 処理 API

Aspose.PDF Cloud SDK for Python は、Aspose.PDF Cloud API のラッパーであり、Python 開発者向けに PDF ファイル処理のすべての機能を提供します。同様に、SDK は複数の PDF ファイルを 1 つの出力ドキュメントにマージ/結合する機能も提供しており、これはすべて数行のコードで実現できます。

インストール

先に進む前に、まずは PIP または GitHub リポジトリから SDK をインストールします。この記事では、PIP からのインストール手順について説明します。ターミナル/コマンド プロンプトで次のコマンドを実行するだけで、最新バージョンの SDK がシステムにインストールされます。

pip install asposepdfcloud

Pycharmへのインストール

PyCharm は Python 開発用の一般的な IDE です。Python IDE で SDK を直接使用するには、以下の手順に従ってください。

PyCharm メニューの下にある [設定] メニュー項目をクリックします。

設定メニュー項目

左のツリーから、プロジェクト セクションの Python インタープリターを選択します。

Pythonインタープリタオプション

次に、右側のセクションの + (プラス) 記号をクリックし、利用可能なパッケージ ダイアログの検索フィールドに asposepdfcloud と入力します。

利用可能なパッケージダイアログ

次に、「パッケージのインストール」ボタンをクリックします。SDK がインストールされると、成功メッセージが表示されます。

PythonでPDFファイルを結合する

Aspose.PDF Cloud は、ドキュメントの保存にクラウドベースのストレージ サービスを使用します。したがって、データの整合性とプライバシーを確保するために、承認されたユーザーのみが API にアクセスできます。そのため、最初の手順は、Aspose.Cloud ダッシュボード にアクセスしてアカウントを作成することです。GitHub または Google アカウントをお持ちの場合は、サインアップするだけです。そうでない場合は、新しいアカウントの作成 ボタンをクリックして、必要な情報を入力します。資格情報を使用してダッシュボードにログインし、ダッシュボードからアプリケーション セクションを展開して、クライアント資格情報セクションまで下にスクロールして、クライアント ID とクライアント シークレットの詳細を確認します。

PDF ドキュメントを結合する手順を以下に示します。

  • まず、ClientSecret と ClientID を引数として渡しながら ApiClient のオブジェクトを作成します。
  • 次に、ApiClient オブジェクトを引数として渡しながら PdfApi インスタンスを作成します。
  • 次に、追加するターゲット PDF、つまり PDF ファイルの開始ページと終了ページを定義する Opts オブジェクトを作成します。
  • 最後に、postappenddocument(…) メソッドを呼び出して PDF マージ操作を実行します。
# https://dashboard.aspose.cloud から ClientId と ClientSecret を取得します (無料登録が必要です)。

#initialize PdfApi client instance using ClientID and ClientSecret
pdf_api_client = asposepdfcloud.api_client.ApiClient("d87269aade6a46cdc295b711e26809af", "a41d01ef-dfd5-4e02-ad29-bd85fe41e3e4")

# PdfApiClient を引数として渡しながら PdfApi インスタンスを作成します。
pdf_api = PdfApi(pdf_api_client)

# ソースPDFドキュメント
file_name = 'PdfWithAnnotations.pdf'

# ページを追加する必要があるPDFファイル
append_file_name = 'PdfWithTable.pdf'

# 連結を定義するオプションインスタンスを作成する PDF
# 連結ファイルの開始ページと終了ページ
opts = {
    "append_file": append_file_name,
    "start_page": 1,
    "end_page": 2
}

# APIを呼び出してページを結合する
response = pdf_api.post_append_document(file_name, **opts)

# コンソールで応答コードをレンダリングする
print(response)

cURLコマンドを使用してPDFファイルを結合する

cURL コマンドは、あらゆるプラットフォームのコマンド ライン ターミナルから REST API にアクセスする便利な方法の 1 つです。SDK をインストールする必要はなく、ターミナル アプリケーションでコマンドを実行するだけで要件を満たすことができます。したがって、cURL コマンドを使用するには、まず JSON Web Token (JWT) を生成して、コマンド プロンプトから API にアクセスできるようにします。同じ JWT トークンが、cURL コマンドから API にアクセスするためにも使用されます。

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=a41d01ef-dfd5-4e02-ad29-bd85fe41e3e4&client_secret=d87269aade6a46cdc295b711e26809af" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

次のコマンドを使用すると、PostAppendDocument API を使用してターゲット PDF がソース/入力 PDF ファイルにマージされます。結果の出力はクラウド ストレージに保存されます。

curl -X POST "https://api.aspose.cloud/v3.0/pdf/PdfWithAnnotations.pdf/appendDocument?appendFile=PdfWithTable.pdf&startPage=2&endPage=3" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"

結論

この記事では、Python REST APIを使用してPDFマージ操作を実行する手順について説明しました。オープンソースタイプであるため、SDKの完全なソースコードはGitHubリポジトリからダウンロードできます。

SDK の機能の詳細については、次のドキュメント トピック「Aspose.PDF Cloud の機能」を参照してください。ただし、API の使用中に問題が発生した場合は、無料の テクニカル サポート フォーラム からお気軽にお問い合わせください。

関連記事

以下の内容を説明する記事も読むことをお勧めします。