Python で REST API を使用して異なるタイプのドキュメントを結合する

同じタイプまたは異なるタイプの異なるドキュメントを結合すると、分散したデータや情報を 1 つのファイルに収集できます。クラウド上で、異なるファイルタイプの複数のドキュメントを 1 つのファイルに簡単に結合できます。この記事では、Python の REST API を使用して、さまざまなファイル タイプのドキュメントを PDF に結合する方法を学びます。

この記事では次のトピックについて説明します。

ファイル結合 REST API と Python SDK

複数のファイルを結合するには、GroupDocs.Merger Cloud の Python SDK API を使用します。 サポートされている文書形式、Word、Excel、PowerPoint、 Visio 図面、PDF、HTML。コンソールで次のコマンドを使用してインストールしてください。

pip install groupdocs-merger-cloud

上記の手順に従う前に、ダッシュボードからクライアント ID とシークレットを取得してください。 ID とシークレットを取得したら、以下に示すようにコードを追加します。

# このコード例は、コードにクライアント ID とシークレットを追加する方法を示しています。
client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"

configuration = groupdocs_merger_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""

Python で REST API を使用して複数のファイル タイプをマージする

以下の手順に従って、複数のファイル タイプのドキュメントをクラウド上でプログラム的に結合できます。

  1. ファイルをクラウドにアップロード
  2. 結合 異なるファイル形式のドキュメント
  3. ダウンロード 結合されたファイル

ファイルをアップロードする

まず、以下のコード例を使用してファイルをクラウドにアップロードします。

# このコード例は、ファイルをクラウドにアップロードする方法を示しています。
# API のインスタンスを作成する
file_api = groupdocs_merger_cloud.FileApi.from_config(configuration)

# サンプルファイルをアップロードする
for filename in glob.iglob("C:\\Files\\Merger\\upload\\*.*", recursive=True):
    destFile = filename.replace("C:\\Files\\Merger\\upload", "", 1)           
    # アップロードファイルリクエストの作成
    request = groupdocs_merger_cloud.UploadFileRequest(destFile, filename)
    # ファイルをアップロードする
    file_api.upload_file(request)

その結果、アップロードされたファイルは、クラウド上のダッシュボードの ファイル セクション で利用できるようになります。

Python で異なるファイルタイプのドキュメントを結合する

ここで、以下の手順に従って、アップロードされたさまざまなタイプのファイルを 1 つのファイルに簡単にマージできます。

  • まず、DocumentApiのインスタンスを作成します。
  • 次に、最初の JoinItem の入力ファイル パスを指定します。
  • 次に、2 番目の JoinItem の入力ファイル パスを指定します。
  • 必要に応じて、上記の手順を繰り返してさらにファイルを追加します。
  • その後、JoinOptions を定義し、出力ファイルのパスを設定します。
  • 最後に、join() メソッドを呼び出し、結合されたドキュメントを保存します。

次のコード サンプルは、Python の REST API を使用してさまざまなファイル タイプをマージする方法を示しています。

# このコード例は、Python でさまざまなファイル タイプのドキュメントを結合する方法を示します。
documentApi = groupdocs_merger_cloud.DocumentApi.from_keys(client_id, client_secret)

# 最初のファイル
item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("sample.pdf")

# 2番目のファイル
item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("sample.docx")

# 参加オプション
options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "joined.pdf"

# JoinOptions を使用して参加リクエストを作成する
request = groupdocs_merger_cloud.JoinRequest(options)

# ファイルを結合する
result = documentApi.join(request)

結合されたファイルをダウンロードする

最後に、上記のコード サンプルは、結合された PDF ファイルをクラウドに保存します。次のコードサンプルを使用してダウンロードできます。

# このコード例は、マージされたファイルをクラウドからダウンロードする方法を示しています。
# APIの初期化
file_api = groupdocs_merger_cloud.FileApi.from_config(configuration)

# ダウンロードファイルリクエストの作成
request = groupdocs_merger_cloud.DownloadFileRequest("joined.pdf", my_storage)

# ダウンロードファイル
response = file_api.download_file(request)

# ダウンロードしたファイルを作業ディレクトリに移動します
shutil.move(response, "C:\\Files\\Merger\\")

PDFとExcelを結合してPDFにする方法

前述の手順に従って、PDF と Excel ファイルを PDF に結合できます。ただし、最初と 2 番目の JoinItem として PDF および Excel ドキュメントのパスを指定する必要があるだけです。次のコード サンプルは、Python の REST API を使用して PDF ドキュメントと Excel シートを PDF ファイルに結合する方法を示しています。

# このコード例は、Python を使用して Word と Excel ファイルを PDF に結合する方法を示します。
documentApi = groupdocs_merger_cloud.DocumentApi.from_keys(client_id, client_secret)

# 最初のファイル
item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("sample.pdf")

# 2番目のファイル
item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("sample.xlsx")

# 参加オプション
options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "joined.pdf"

# JoinOptions を使用して参加リクエストを作成する
request = groupdocs_merger_cloud.JoinRequest(options)

# ファイルを結合する
result = documentApi.join(request)

PDF と PowerPoint を結合して PDF にする方法

前述の手順に従って、PDF ドキュメントと PowerPoint プレゼンテーションを PDF に結合することもできます。ただし、最初と 2 番目の JoinItem として PDF と PowerPoint のドキュメント パスを指定する必要があるだけです。次のコード サンプルは、Python の REST API を使用して PDF ドキュメントと PowerPoint プレゼンテーションを PDF ファイルに結合する方法を示しています。

# このコード例は、Python を使用して Word と PowerPoint のプレゼンテーションを PDF に結合する方法を示します。
documentApi = groupdocs_merger_cloud.DocumentApi.from_keys(client_id, client_secret)

# 最初のファイル
item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("sample.pdf")

# 2番目のファイル
item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("sample.pptx")

# 参加オプション
options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "joined.pdf"

# JoinOptions を使用して参加リクエストを作成する
request = groupdocs_merger_cloud.JoinRequest(options)

# ファイルを結合する
result = documentApi.join(request)

Python で異なるファイルタイプの特定のページを結合する

以下の手順に従って、さまざまな種類のドキュメントから選択したページを 1 つのファイルに結合できます。

  • まず、DocumentApiのインスタンスを作成します。
  • 次に、最初の JoinItem の入力ファイル パスを指定します。
  • 次に、結合する特定のページ番号を指定します。
  • 次に、2 番目の JoinItem の入力ファイル パスを指定します。
  • 次に、結合するページ範囲を開始ページ番号と終了ページ番号で定義します。
  • その後、JoinOptions を定義し、出力ファイルのパスを設定します。
  • 最後に、join() メソッドを呼び出し、結合されたドキュメントを保存します。

次のコード サンプルは、Python の REST API を使用して、さまざまなファイル タイプの特定のページをマージする方法を示しています。

# このコード例は、Python でさまざまなファイル タイプのドキュメントを結合する方法を示します。
documentApi = groupdocs_merger_cloud.DocumentApi.from_keys(client_id, client_secret)

# 最初のファイル
item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("sample.pdf")
# 最初の文書から結合するページ番号
item1.pages = [1, 2]

# 2番目のファイル
item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("sample.docx")
# 2 番目のドキュメントから結合するページ範囲
item2.start_page_number = 1
item2.end_page_number = 3
  
# 参加オプション
options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "joined.pdf"

# JoinOptions を使用して参加リクエストを作成する
request = groupdocs_merger_cloud.JoinRequest(options)

# ファイルを結合する
result = documentApi.join(request)

オンラインで試す

上記の API を使用して開発された、次の無料のオンライン結合ツールをお試しください。 https://products.groupdocs.app/merger/

結論

この記事では、次のことを学びました。

  • Python で複数のファイルタイプのドキュメントを結合する方法。
  • Python でさまざまなファイルタイプのドキュメントから特定のページを結合する方法。
  • 複数のファイルをクラウドにアップロードします。
  • 結合された PDF をクラウドからダウンロードする方法。

さらに、GroupDocs.Merge Cloud API の詳細については、ドキュメント を使用して学習できます。また、ブラウザーを通じて API を直接視覚化し操作できるようにする API リファレンス セクションも提供しています。ご不明な点がございましたら、foまでお気軽にお問い合わせください。

関連項目