Python の REST API を使用して PDF から注釈を削除します。

注釈は、コメント、ポップアップ、その他のさまざまなグラフィック オブジェクトの形式でドキュメントに追加情報を提供します。場合によっては、注釈付き PDF ドキュメントから注釈を削除する必要がある場合があります。この記事では、Python の REST API を使用して PDF ドキュメントから注釈を削除または抽出する方法を学びます。

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

注釈を削除するための REST API と Python SDK

PDF ドキュメントから注釈を抽出または削除するには、GroupDocs.Annotation Cloud の Python SDK API を使用します。注釈、透かしオーバーレイ、テキスト置換とマークアップ、付箋を サポートされているドキュメント形式 に追加できます。コンソールで次のコマンドを使用してインストールしてください。

pip install groupdocs_annotation_cloud

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

# このコード例は、ClientID と Secret を追加する方法を示しています。
client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"

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

Python の REST API を使用して PDF ファイルから注釈を削除する

以下の簡単な手順に従って、PDF ファイルからすべての注釈を削除できます。

ドキュメントをアップロードする

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

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

# サンプルファイルをアップロードする
request = groupdocs_annotation_cloud.UploadFileRequest("sample.pdf", "C:\\Files\\sample.pdf", my_storage)
response = file_api.upload_file(request)

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

Python で PDF から注釈を削除する

ここで、以下の手順に従って、プログラムによって PDF ドキュメントから注釈を削除します。

  • まず、AnnotateApi のインスタンスを作成します。
  • 次に、FileInfo のインスタンスを作成します。
  • 次に、入力 PDF ファイルのパスを設定します。
  • 次に、RemoveOptions のインスタンスを作成します。
  • 次に、FileInfo を RemoveOptions に割り当てます。
  • 次に、削除するアノテーション ID をカンマ区切りの配列で指定します。
  • 次に、出力ファイルのパスを設定します。
  • その後、RemoveOptions オブジェクトを使用して RemoveAnnotationsRequest メソッドを呼び出してリクエストを作成します。
  • 最後に、RemoveAnnotationsRequest を引数として AnnotateApi.remove\annotations() メソッドを呼び出して結果を取得します。

次のコード サンプルは、Python の REST API を使用して PDF ドキュメントから注釈を削除する方法を示しています。ドキュメントから削除する注釈 ID について言及する必要があるだけです。 こちら で説明されているように、ExtractRequest で extract() メソッドを使用してアノテーション ID を取得できます。

# このコード例は、PDF から注釈を削除する方法を示しています。
# APIインスタンス
api = groupdocs_annotation_cloud.AnnotateApi(configuration)

# 入力ファイルの詳細
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"

# オプションを削除する
options = groupdocs_annotation_cloud.RemoveOptions()
options.file_info = file_info
options.annotation_ids = [0,1,2]

# 出力ファイル
options.output_path = "annotations_removed.pdf"

# 削除リクエスト
request = groupdocs_annotation_cloud.RemoveAnnotationsRequest(options)
result = api.remove_annotations(request)

print("RemoveAnnotations: Annotations removed: " + result['href'])
Python で PDF から注釈を削除します。

Python で PDF から注釈を削除します。

出力ファイルをダウンロードする

上記のコード サンプルは、クラウド上の PDF ファイルから注釈を削除した後、出力ファイルを保存します。次のコードサンプルを使用してダウンロードできます。

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

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

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

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

Python で PDF ドキュメントから注釈を抽出する

以下の手順に従って、PDF ドキュメントからプログラムで注釈を抽出できます。

  • まず、AnnotateApi のインスタンスを作成します。
  • 次に、FileInfo のインスタンスを作成します。
  • 次に、入力ファイルのパスを設定します。
  • その後、FileInfo オブジェクトを使用して ExtractRequest メソッドを呼び出してリクエストを作成します。
  • 最後に、ExtractRequest を引数として AnnotateApi.extract() メソッドを呼び出して結果を取得します。

次のコード サンプルは、Python の REST API を使用して PDF ドキュメントから注釈を抽出する方法を示しています。

# このコード例は、PDF ファイルから注釈を抽出する方法を示します。
# APIインスタンス
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)

# 入力ファイルの詳細
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"

# 注釈の抽出リクエスト
request = groupdocs_annotation_cloud.ExtractRequest(file_info)
result = api.extract(request)        

print("ExtractAnnotations: annotations count: " + str(len(result)))

# 表示結果
for x in range(len(result)):
  print(result[x]);

上記のコード サンプルは、以下に示すように、すべての注釈の配列を JSON 形式で返します。

Python で PDF ドキュメントから注釈を抽出します。

Python で PDF ドキュメントから注釈を抽出します。

オンラインで試す

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

結論

この記事では、クラウド上の PDF ドキュメントから注釈を削除する方法を学びました。 Python を使用して PDF ドキュメントから注釈を抽出する方法についても説明しました。この記事では、プログラムで PDF ファイルをクラウドにアップロードし、クラウドからファイルをダウンロードする方法についても説明しました。さらに、ドキュメント を使用すると、GroupDocs.Annotation Cloud API についてさらに詳しく学ぶことができます。また、ブラウザーを通じて直接 API を視覚化し操作できるようにする API リファレンス セクションも提供しています。不明な点がある場合は、フォーラム でお気軽にお問い合わせください。

関連項目