如何在 Ruby 中使用 REST API 合并和组合 PDF 文件
您可以使用 REST API 在云端以编程方式将 PDF 文档组合成单个 PDF 文件。它可以用于共享或打印合并在一个文件中的多个文档，而不是一个一个地处理所有文件。作为 Ruby 开发人员，您可以在 Ruby 应用程序中将两个或多个 PDF 文件合并为一个文件。在本文中，您将学习如何在 Ruby 中使用 REST API 合并和组合 PDF 文件。
本文应涵盖以下主题：
PDF 合并 REST API 和 Ruby SDK
为了合并两个或多个 pdf 文件，我将使用 GroupDocs.Merger Cloud API 的 Ruby SDK。它允许您将两个或多个文档合并为一个文档，或将一个源文档拆分为多个结果文档。它还使您能够移动、删除、交换、旋转或更改整个页面或首选页面范围的纵向或横向页面方向。 SDK支持Word、Excel、PowerPoint, Visio、OneNote、HTML等所有流行文档格式的合并和拆分。
您可以在控制台中使用以下命令将 GroupDocs.Merger Cloud 安装到您的 Ruby 应用程序：
gem install groupdocs_merger_cloud
在执行上述步骤之前，请从 dashboard 获取您的 Client ID 和 Secret。获得 ID 和密码后，添加如下所示的代码：
# 加载 PDF 文件合并 gem
require 'groupdocs_merger_cloud'
# 获取客户端 ID 和客户端密码
@client_id = "xxxxxxxxx-xxxxx-xxxx-xxxxxxxxxx"
@client_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
在 Ruby 中使用 REST API 合并多个 PDF 文件
您可以按照下面提到的简单步骤，以编程方式在云端合并两个或多个 PDF 文件。您可以 上传 PDF 文档到云端，因此，上传的 PDF 文件将在云端仪表板的 文件部分 中可用。您可以按照下面提到的步骤以编程方式轻松地将多个 PDF 文档合并到一个文件中：
- 创建 DocumentApi 的实例
- 创建 JoinItem 的实例
- 为 FileInfo 中的第一个 JoinItem 设置输入文件路径
- 为第二个文档创建 JoinItem 的新实例
- 为 FileInfo 中的第二个 JoinItem 提供输入文件路径
- 添加更多 JoinItems 以合并更多 PDF 文件
- 创建 JoinOptions 的实例
- 添加已创建连接项的逗号分隔列表
- 在云端设置输出文件路径
- 使用 JoinOptions 创建 JoinRequest 的实例
- 使用 JoinRequest 调用 DocumentAPI 的 join() 方法获取结果
以下代码片段展示了如何在 Ruby 中使用 REST API 合并多个 PDF 文件。
# 如何使用 Ruby 使用 REST API 合并多个 PDF 文件
# 创建文档 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 文件的特定页面合并到一个文件中：
- 创建 DocumentApi 的实例
- 创建 JoinItem 的实例
- 为 FileInfo 中的第一个 JoinItem 设置输入文件路径
- 定义要合并的页码列表
- 创建 JoinItem 的另一个实例
- 为 FileInfo 中的第二个 JoinItem 设置输入文件路径
- 定义起始页码和结束页码
- 将页面范围模式定义为 OddPages
- 创建 JoinOptions 的实例
- 添加已创建连接项的逗号分隔列表
- 在云端设置输出文件路径
- 使用 JoinOptions 创建 JoinRequest 的实例
- 最后，通过使用 JoinRequest 调用 DocumentAPI 的 join() 方法来合并文档
以下代码片段显示了如何使用 Ruby 中的 REST API 合并来自多个 PDF 文件的特定页面。
# 如何使用 Ruby 合并多个 PDF 文件的特定页面
# 创建文档 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 文档的特定页面组合成一个文件。 PDF 合并 REST API 还为 Cloud API 提供 .NET、Java、PHP、Python、Android 和 Node.js SDK 作为其 文档合并家族成员。您可以使用 文档 了解有关 GroupDocs.Merge Cloud API 的更多信息。我们还提供了一个 API 参考 部分，让您可以直接通过浏览器可视化我们的 API 并与之交互。
问一个问题
如果您对如何合并多个 PDF 文档有任何疑问，请随时在免费支持论坛 中提问，我们将在几个小时内为您解答。