Microsoft Word 提供了一個很棒的功能來跟踪更改並保留 Word 文檔的修訂。作為 Python 開發人員，您可以在雲端以編程方式接受或拒絕 Word 文檔 (.docx) 的跟踪更改。本文將重點介紹如何在 Python 中使用 REST API 接受或拒絕 Word 文檔的跟踪更改。
本文應涵蓋以下主題：
文檔對比 REST API 和 Python SDK
為了處理修訂，我將使用 GroupDocs.Comparison Cloud 的 Python SDK API。它比較受支持文件格式的兩個文檔並找出它們之間的差異。結果，它創建了一個包含差異的結果文件。它還使您能夠接受或拒絕檢索到的更改。您可以輕鬆地將 SDK 集成到您現有的 Python 應用程序中。它使您能夠比較文檔、電子表格、演示文稿、Microsoft Visio 圖表、電子郵件和許多其他格式的文件。它還提供 .NET、Java、PHP、Node.js 和 Ruby SDK 作為 Cloud API 的文檔比較家族成員。
您可以在控制台中使用以下命令將 GroupDocs.Comparison Cloud 安裝到您的 Python 項目：
pip install groupdocs_comparison_cloud
在開始執行步驟和可用代碼示例之前，請從 dashboard 獲取您的 Client ID 和 Client Secret。獲得 ID 和密碼後，添加如下所示的代碼：
client_id = "112f0f38-9dae-42d5-b4fc-cc84ae644972"
client_secret = "16ad3fe0bdc39c910f57d2fd48a5d618"
configuration = groupdocs_comparison_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""
在 Python 中使用 REST API 接受或拒絕跟踪更改
您可以按照下面提到的簡單步驟接受或拒絕 Word 文檔的特定修訂：
- 上傳DOCX文件到雲端
- 使用 Python 接受或拒絕更改
- 下載 生成的文件
上傳文件
首先，使用下面給出的代碼示例將修改後的Word文檔上傳到雲端：
# 創建 API 實例
file_api = groupdocs_comparison_cloud.FileApi.from_config(configuration)
request = groupdocs_comparison_cloud.UploadFileRequest("source_with_revs.docx", "C:\\Files\\source_with_revs.docx", "")
response = file_api.upload_file(request)
因此，上傳的 DOCX 文件將在雲端儀表板的 文件部分 中可用。
使用 Python 接受或拒絕更改
請按照下面提到的步驟以編程方式接受或拒絕修訂。
- 創建 ReviewApi 實例
- 設置源 .docx 文件
- 定義 ApplyRevisionsOptions
- 分配源並設置輸出文件
- 創建 GetRevisionsRequest
- 通過調用 ReviewApi.get\revisions() 方法獲取修訂
- 將每個修訂的修訂操作設置為“接受”或“拒絕”
- 將更新的修訂分配給 ApplyRevisionsOptions
- 創建 ApplyRevisionsRequest
- 通過調用 ReviewApi.apply\revisions() 方法獲取結果
以下代碼示例顯示如何使用 REST API 接受跟踪的更改。
# 創建 API 實例
api_instance = groupdocs_comparison_cloud.ReviewApi.from_keys(client_id, client_secret)
# 設置源文件
source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_with_revs.docx"
options = groupdocs_comparison_cloud.ApplyRevisionsOptions()
options.source_file = source
options.output_path = "output/result.docx"
request = groupdocs_comparison_cloud.GetRevisionsRequest(options)
revisions = api_instance.get_revisions(request)
# 獲取所有修訂計數
print("Revisions count: " + str(len(revisions)))
# 接受修改
for revision in revisions:
revision.action = "Accept"
options.revisions = revisions
request = groupdocs_comparison_cloud.ApplyRevisionsRequest(options)
response = api_instance.apply_revisions(request)
使用 Python 接受更改
如果拒絕任何更改，您可以使用以下代碼示例：
for revision in revisions:
revision.action = "Reject"
下載結果文件
因此，上述代碼示例將在雲端保存一個新創建的包含更改的 DOCX 文件。您可以使用以下代碼示例下載它：
# API初始化
file_api = groupdocs_comparison_cloud.FileApi.from_config(configuration)
request = groupdocs_comparison_cloud.DownloadFileRequest("output\\result.docx", my_storage)
response = file_api.download_file(request)
# 將下載的文件移動到您的工作目錄
shutil.move(response, "C:\\Files\\")
使用 Python 接受或拒絕所有更改
請按照下面提到的步驟以編程方式一次接受或拒絕所有更改。
- 創建 ReviewApi 實例
- 設置源 .docx 文件
- 定義 ApplyRevisionsOptions
- 然後分配源並設置輸出文件
- 將 accept\all 設置為“True”以接受所有更改
- 或者將 reject\all 設置為“True”以拒絕所有更改
- 然後將更新的修訂分配給 ApplyRevisionsOptions
- 創建 ApplyRevisionsRequest
- 調用ReviewApi.apply\revisions()方法獲取結果
以下代碼示例顯示如何使用 REST API 接受所有更改。請按照前面提到的步驟上傳和下載文件。
# 創建 API 實例
api_instance = groupdocs_comparison_cloud.ReviewApi.from_keys(client_id, client_secret)
# 設置源文件
source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_with_revs.docx"
options = groupdocs_comparison_cloud.ApplyRevisionsOptions()
options.source_file = source
options.output_path = "output/result.docx"
# 接受所有修訂
options.accept_all = True
request = groupdocs_comparison_cloud.ApplyRevisionsRequest(options)
response = api_instance.apply_revisions(request)
您可以使用以下代碼示例拒絕所有修訂：
options.reject_all = True
在線試用
請試用以下使用上述 API 開發的免費在線 Word 比較工具。 https://products.groupdocs.app/comparison/docx
結論
在本文中，您了解瞭如何使用 Python 接受或拒絕雲端 Microsoft Word 文檔的修訂。您還學習瞭如何以編程方式將 DOCX 文件上傳到雲端，然後從雲端下載生成的文件。您可以使用 文檔 了解有關 GroupDocs.Comparison Cloud API 的更多信息。我們還提供了一個 API 參考 部分，讓您可以直接通過瀏覽器可視化我們的 API 並與之交互。如有任何歧義，請隨時在論壇上與我們聯繫。