JavaでPDFメタデータを編集する：開発者向けステップバイステップガイド

GroupDocs.Metadata Cloud SDK for Java は、Java 開発者がプログラムで PDF ドキュメントのプロパティを読み取り、変更できるようにします。このガイドでは、Java で PDF メタデータを編集し、Title や Author などの標準フィールドを更新し、カスタムのキー‑バリューペアを追加する方法を学びます。SDK は、PDF をロードし、メタデータを変更し、ファイルをストレージに保存するシンプルな API を提供します。ステップバイステップの手順に従って、Java アプリケーションにメタデータ編集機能を統合してください。

前提条件とセットアップ

PDF メタデータを操作するには、Java 8 以上と、開発マシンに Maven がインストールされている必要があります。最新バージョンはこのページからダウンロードしてください。

Maven プロジェクトに SDK を追加します:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-metadata-cloud</artifactId>
    <version>23.9</version>
</dependency>

または、コマンドラインでインストールします:

mvn install com.groupdocs:groupdocs-metadata-cloud

GroupDocs Cloud ダッシュボードから取得したクライアント ID とクライアントシークレットを使用して、構成ファイル（または環境変数）を作成します。この例ではライセンスコードは必要ありません。テンポラリライセンスはライセンスページからリクエストできます。

PDF メタデータの理解

PDF ファイルには、標準プロパティ (Title、Author、Subject、Keywords) のセットが含まれており、カスタムのキー‑バリューペアも許可されています。これらのプロパティはドキュメントのメタデータ辞書に保存されており、ファイルの視覚的な内容を変更せずに読み取ったり変更したりできます。

GroupDocs.Metadata Cloud SDK for Java の主な機能

PDF、DOCX、XLSX、およびその他多数の形式から既存のメタデータを読み取ります。
Title、Author、Creator、Producer などの標準プロパティを更新します。
シンプルなマップインターフェイスを使用してカスタムプロパティを追加、編集、または削除します。
変更を元のファイルに戻すか、新しい出力先に保存します。

標準 PDF ドキュメントプロパティの変更

SDKは、すべての標準フィールドの getter と setter を提供する MetadataInfo クラスを公開しています。CustomProperties コレクションにアクセスして、ユーザー定義エントリを操作することもできます。

カスタムメタデータフィールドの追加

カスタムメタデータは文字列キーと値の辞書として保存されます。SDKはドキュメントが保存される際にこれらのエントリを自動的にシリアライズし、カスタムメタデータをサポートするすべての PDF リーダーで利用できるようにします。

JavaでPDFメタデータを編集する手順

API クライアントを初期化: 資格情報で Configuration オブジェクトを作成し、MetadataApi をインスタンス化します。
ソース PDF をアップロード: StorageApi を使用してファイルを GroupDocs Cloud ストレージに配置します。
PDF メタデータをロード: metadataApi.getMetadataInfo を呼び出して MetadataInfo オブジェクトを取得します。
フィールドを更新: 標準プロパティ（例: setTitle、setAuthor）を設定し、getCustomProperties().put("MyKey", "MyValue") でカスタムエントリを追加します。
変更を保存: metadataApi.updateMetadataInfo を呼び出して、変更されたメタデータをファイルに書き戻します。

使用されているクラスの詳細については、API リファレンスをご参照ください。

Java で PDF メタデータを編集 - 完全なコード例

次の例は、認証、ファイルのアップロード、メタデータの変更、そして更新された PDF の保存という完全なワークフローを示しています。

注意: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパス（sample.pdf、C:/files/sample.pdf）を実際の場所に合わせて更新し、必要な依存関係がすべて正しくインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメントをご参照いただくか、サポートチームにお問い合わせください。

cURL を使用した REST API で PDF メタデータを編集する

Java ライブラリを使用したくない場合、同じ操作は GroupDocs Metadata Cloud REST API を介して実行できます。

アクセストークンを取得する

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

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

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@C:/files/sample.pdf"

メタデータを更新する

curl -X POST "https://api.groupdocs.cloud/v2.0/metadata/pdf/sample.pdf/metadata" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "title":"New Document Title",
           "author":"John Doe",
           "subject":"Updated Subject",
           "customProperties":{"Project":"Alpha","ReviewedBy":"Jane Smith"}
         }'

更新された PDF をダウンロード

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "C:/files/updated_sample.pdf"

これらのコマンドを使用すると、スクリプトや CI/CD パイプライン、または Java ライブラリのインストールが実用的でない環境に PDF メタデータ編集を統合できます。エンドポイントの完全な一覧については、API ドキュメントを参照してください。

結論

GroupDocs.Metadata Cloud SDK for Java を使用して Java で PDF メタデータを編集する方法について、完全に理解できました。このガイドでは、既存のメタデータの読み取り、Title や Author などの標準フィールドの変更、カスタムのキー‑バリューペアの追加、変更の永続化について説明しました。SDK はローカルマシンまたはサーバー上で実行され、有効なライセンスが必要です。まずはライセンスページから一時ライセンスを取得し、本番環境ではフル商用ライセンスにアップグレードできます。これらの手法を取り入れて、PDF ドキュメントを整理整頓し、検索しやすく保ちましょう。

よくある質問

JavaでGroupDocs.Metadata Cloud SDKを使用してPDFメタデータを編集するにはどうすればよいですか？
SDKを使用してPDFをロードし、MetadataInfoプロパティを変更してファイルを保存します。詳細については、GroupDocs.Metadata Cloud SDK for Java のドキュメントをご覧ください。

PDF のメタデータにカスタムのキーと値のペアを追加できますか？
はい、SDK は setCustomProperties メソッドを使用してカスタムエントリの追加をサポートしています。例については、API リファレンスを参照してください。

一時ライセンスは開発に十分ですか？
ライセンスページの一時ライセンスで SDK をテストできます。本番環境では、フルライセンスを購入してください。

PDF メタデータ操作のさらなるサンプルはどこで見つけられますか？
公式のドキュメントとフォーラムには、追加のサンプルとコミュニティサポートが含まれています。

前提条件とセットアップ#

PDF メタデータの理解#

GroupDocs.Metadata Cloud SDK for Java の主な機能#

標準 PDF ドキュメント プロパティの変更#

カスタム メタデータ フィールドの追加#

JavaでPDFメタデータを編集する手順#

Java で PDF メタデータを編集 - 完全なコード例#

cURL を使用した REST API で PDF メタデータを編集する#

結論#

よくある質問#

詳細を見る#