Ruby で REST API を使用して PDF ファイルをマージおよび結合する方法

Ruby で REST API を使用して PDF ファイルをマージおよび結合する方法

PDF ドキュメントは、REST API を使用してクラウド上でプログラム的に単一の PDF ファイルに結合できます。すべてのファイルを 1 つずつ処理するのではなく、複数のドキュメントを 1 つのファイルに結合して共有したり印刷したりする場合に便利です。 Ruby 開発者は、Ruby アプリケーションで 2 つ以上の PDF ファイルを 1 つのファイルに結合できます。この記事では、Ruby の REST API を使用して PDF ファイルを結合および結合する方法を学習します。

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

PDF Merger REST API と Ruby SDK

2 つ以上の PDF ファイルを結合するには、GroupDocs.Merger Cloud API の Ruby SDK を使用します。 2 つ以上のドキュメントを 1 つのドキュメントに結合したり、1 つのソース ドキュメントを複数の結果ドキュメントに分割したりできます。また、ページ全体または優先範囲に対して、ページの向きを移動、削除、交換、回転、または縦または横に変更することもできます。 SDK は、Word、Excel、PowerPoint, Visio、OneNote、HTML などのすべての一般的なドキュメント形式の結合と分割をサポートしています。

コンソールで次のコマンドを使用して、GroupDocs.Merger Cloud を Ruby アプリケーションにインストールできます。

gem install groupdocs_merger_cloud

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

# PDF ファイル結合 gem をロードする
require 'groupdocs_merger_cloud'

# クライアント ID とクライアント シークレットを取得する
@client_id = "xxxxxxxxx-xxxxx-xxxx-xxxxxxxxxx"
@client_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Ruby の REST API を使用して複数の PDF ファイルを結合する

以下に説明する簡単な手順に従って、クラウド上で 2 つ以上の PDF ファイルをプログラム的に結合できます。 PDF ドキュメントをクラウドに アップロード することができ、その結果、アップロードされた PDF ファイルはクラウド上のダッシュボードの ファイル セクション で利用できるようになります。以下の手順に従って、複数の PDF ドキュメントをプログラムで簡単に 1 つのファイルに結合できます。

  • DocumentApi のインスタンスを作成します。
  • JoinItem のインスタンスを作成する
  • FileInfo の最初の JoinItem の入力ファイル パスを設定します。
  • 2 番目のドキュメントの JoinItem の新しいインスタンスを作成します。
  • FileInfo の 2 番目の JoinItem の入力ファイル パスを指定します。
  • さらに JoinItem を追加して、より多くの PDF ファイルを結合します
  • JoinOptions のインスタンスを作成する
  • 作成された結合項目のカンマ区切りリストを追加します
  • クラウド上の出力ファイルのパスを設定する
  • JoinOptions を使用して JoinRequest のインスタンスを作成する
  • JoinRequest を使用して DocumentAPI の join() メソッドを呼び出して結果を取得します

次のコード スニペットは、Ruby で REST API を使用して複数の PDF ファイルを結合する方法を示しています。

# Rubyを使用したREST APIを使用して複数のPDFファイルを結合する方法
# Document API のインスタンスを作成する
@mergerApi = GroupDocsMergerCloud::DocumentApi.from_keys(@client_id, @client_secret)
 
@item1 = GroupDocsMergerCloud::JoinItem.new
@item1.file_info = GroupDocsMergerCloud::FileInfo.new
@item1.file_info.file_path = 'merge/four-pages.pdf'
 
@item2 = GroupDocsMergerCloud::JoinItem.new
@item2.file_info = GroupDocsMergerCloud::FileInfo.new
@item2.file_info.file_path = 'merge/one-page.pdf'       
 
@options = GroupDocsMergerCloud::JoinOptions.new
@options.join_items = [@item1, @item2]
@options.output_path = "merge/combine-files.pdf"

@result = @mergerApi.join(GroupDocsMergerCloud::JoinRequest.new(@options))
puts("Successfully merged PDF files using REST API in Ruby.")

上記のコードサンプルは、結合された PDF ファイルをクラウド上に保存します。

Rubyを使用して複数のPDFファイルの特定のページを結合する

以下の手順に従って、複数の PDF ファイルの特定のページをプログラムで簡単に 1 つのファイルに結合できます。

  • DocumentApi のインスタンスを作成します。
  • JoinItem のインスタンスを作成する
  • FileInfo の最初の JoinItem の入力ファイル パスを設定します。
  • 結合するページ番号のリストを定義する
  • JoinItem の別のインスタンスを作成する
  • FileInfo の 2 番目の JoinItem の入力ファイル パスを設定します。
  • 開始ページ番号と終了ページ番号を定義する
  • ページ範囲モードを OddPages として定義します。
  • JoinOptions のインスタンスを作成する
  • 作成された結合項目のカンマ区切りリストを追加します
  • クラウド上の出力ファイルのパスを設定する
  • JoinOptions を使用して JoinRequest のインスタンスを作成する
  • 最後に、JoinRequest を使用して DocumentAPI の join() メソッドを呼び出してドキュメントを結合します。

次のコード スニペットは、Ruby の REST API を使用して複数の PDF ファイルから特定のページを結合する方法を示しています。

# Rubyを使用して複数のPDFファイルの特定のページを結合する方法
# Document API のインスタンスを作成する
@mergerApi = GroupDocsMergerCloud::DocumentApi.from_keys(@client_id, @client_secret)

@item1 = GroupDocsMergerCloud::JoinItem.new
@item1.file_info = GroupDocsMergerCloud::FileInfo.new
@item1.file_info.file_path = 'merge/ten-pages.pdf'
@item1.pages = [1, 5, 7]
 
@item2 = GroupDocsMergerCloud::JoinItem.new
@item2.file_info = GroupDocsMergerCloud::FileInfo.new
@item2.file_info.file_path = 'merge/four
-pages.pdf'       
@item2.start_page_number = 1
@item2.end_page_number = 4
@item2.range_mode = "OddPages"
 
@options = GroupDocsMergerCloud::JoinOptions.new
@options.join_items = [@item1, @item2]
@options.output_path = "merge/join-pages.pdf"

@result = @mergerApi.join(GroupDocsMergerCloud::JoinRequest.new(@options))
puts("Merged multiple PDF files using Rest API.")

無料のオンライン PDF 結合

上記APIを利用して開発された下記の無料オンラインPDF結合ツールをお試しください。 PDF 結合ツールを使用すると、どのデバイスからでもオンラインで PDF を結合できます。

まとめ

このブログ投稿では、クラウド上で複数の PDF ファイルを結合する方法を学びました。また、Ruby を使用して複数の PDF ドキュメントの特定のページを 1 つのファイルに結合する方法も学びました。 PDF 結合 REST API は、クラウド API の ドキュメント結合ファミリー メンバー として .NET、Java、PHP、Python、Android、および Node.js SDK も提供します。 GroupDocs.Merge Cloud API の詳細については、ドキュメント を使用して学習できます。また、ブラウザーを通じて直接 API を視覚化し操作できるようにする API リファレンス セクションも提供しています。

質問する

複数の PDF ドキュメントを結合する方法についてご質問がある場合は、無料サポート フォーラム でお気軽にお問い合わせください。数時間以内に回答いたします。

関連項目