EPUBメタデータの編集

急速に進化するデジタル環境の中で、電子書籍 (EPUB) は、その利便性とアクセシビリティにより、非常に人気を得ています。ただし、これらの電子書籍のメタデータの管理は、多くの場合、重要であるにもかかわらず見落とされている側面です。メタデータには、タイトル、著者、発行日など、電子書籍に関する重要な情報が含まれます。このブログ投稿では、Java と GroupDocs.Metadata Cloud API の機能を利用して、REST API を使用して EPUB 電子書籍メタデータを簡単に変更する方法を検討します。さらに、GroupDocs.Metadata Cloud SDK for Java のセットアップと、指定されたタグを使用したメタデータ プロパティの変更に関する段階的な手順も提供します。ボーナスとして、メタデータ管理エクスペリエンスを強化する オンライン EPUB メタデータ エディター も導入します。

この記事では次の点について説明します。

環境のセットアップ

前提条件:

実装を詳しく検討する前に、次の前提条件が満たされていることを確認してください。

  • Java 開発キット (JDK) がインストールされている。
  • API 認証情報を取得するための GroupDocs アカウント。
  • REST API と Java プログラミングの基本的な理解。

API 認証情報の取得:

まず、GroupDocs クラウド アカウントにサインアップし、アプリケーションを作成します。 ダッシュボード は、リクエストを認証するために必要な認証情報 (アプリ SID と アプリ キー) を提供します。

Java 用 GroupDocs.Metadata Cloud SDK の追加:

SDK を Java プロジェクトに組み込むには、API の JAR ファイルを ダウンロード するか、Maven を使用して次のリポジトリと依存関係をプロジェクトの pom.xml ファイルに追加してインストールします。

Maven リポジトリ:

<repository>
    <id>groupdocs-artifact-repository</id>
    <name>GroupDocs Artifact Repository</name>
    <url>https://repository.groupdocs.cloud/repo</url>
</repository>

Maven 依存関係:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-metadata-cloud</artifactId>
    <version>23.3</version>
    <scope>compile</scope>
</dependency>

APIクライアントの初期化

API クライアントを設定するには、以下に示すコードで クライアント ID と クライアント シークレット を使用してください。

String clientId = "APP_SID";
String clientSecret = "APP_KEY";
String myStorage = "";
Configuration configuration = new Configuration(clientId, clientSecret);
view raw initialize-API-client.java hosted with ❤ by GitHub

EPUB メタデータのプロパティの変更

EPUB 電子書籍を読み込んでいます:

まず、変更したいEPUB電子書籍をアップロードします。これは、次のいずれかの方法を使用してファイルをクラウド ストレージにアップロードすることで実現できます。

// api initialization
FileApi apiInstance = new FileApi(clientId, clientSecret);
// input file
File fileStream = new File("C:\\Files\\sample.epub");
// create file upload request
UploadFileRequest request = new UploadFileRequest("sample.epub", fileStream, myStorage);
// upload file
FilesUploadResult response = apiInstance.uploadFile(request);
view raw upload-file.java hosted with ❤ by GitHub

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

一般的な EPUB メタデータ プロパティ:

EPUB ファイルに含まれる一般的なメタデータ プロパティをいくつか示します。

  • タイトル: 電子書籍のタイトル。
  • 作成者: 電子書籍の著者または作成者。
  • 言語: 電子書籍コンテンツの言語。
  • 出版社: 電子書籍の出版社。
  • 説明: 電子書籍の簡単な説明または概要。
  • 日付: 電子書籍の発行日または作成日。
  • 件名: 電子書籍の内容を説明するキーワードまたは語句。
  • 権利: 電子書籍に関連付けられた権利と許可に関する情報。
  • 寄稿者: 他の寄稿者または寄稿者の役割 (編集者、イラストレーターなど)。
  • タイプ: コンテンツのタイプ (小説、教科書など)。
  • 形式: 電子書籍ファイルの形式 (EPUB など)。
  • 識別子: 電子書籍の一意の識別子 (ISBN、DOI など)。
  • 対象範囲: 電子書籍コンテンツの地理的または時間的範囲。
  • ソース: 電子書籍のコンテンツのソース (該当する場合)。

REST API を使用して Java で EPUB メタデータを変更する

ここでは、REST API を使用して Java で EPUB メタデータを変更する方法を示す手順とサンプル コードを示します。

  1. MyAppSid と MyAppKey を使用して構成オブジェクトを作成します。
  2. 作成した構成を使用して MetadataApi インスタンスを初期化します。
  3. メタデータ設定を構成するための SetOptions オブジェクトを作成します。
  4. メタデータ プロパティを保持するために SetProperty オブジェクトの ArrayList を初期化します。
  5. 単一のメタデータ プロパティを表す SetProperty オブジェクトを作成します。
  6. SearchCriteria オブジェクトを作成して、メタデータの検索基準を定義します。
  7. TagOptions オブジェクトを作成して、タグとカテゴリを使用して正確なタグ オプションを指定します。
  8. Tag オブジェクトを作成し、その名前を「Creator」に、カテゴリを「person」に設定します。
  9. 作成した タグを使用して、TagOptions に正確なタグを設定します。
  10. 作成した TagOptions を使用して検索条件を設定します。
  11. 新しいメタデータ値を設定し、プロパティを入力し、プロパティ リストに追加します。 7
  12. EPUB ファイルのファイル パスなどのファイル情報を構成します。
  13. オプションを使用して SetRequest を作成します。
  14. 最後に、MetadataApi インスタンスで set メソッドを呼び出し、SetResult 応答を保存します。

次のコード例は、REST API を使用して Java で EPUB メタデータを変更する方法を示しています。

Configuration configuration = new Configuration(MyAppSid, MyAppKey);
MetadataApi apiInstance = new MetadataApi(configuration);
SetOptions options = new SetOptions();
ArrayList<SetProperty> properties = new ArrayList<SetProperty>();
SetProperty property = new SetProperty();
SearchCriteria searchCriteria = new SearchCriteria();
// Set exact tag options with tag and category
TagOptions tagOptions = new TagOptions();
Tag tag = new Tag();
tag.setName("Creator");
tag.setCategory("Person");
tagOptions.setExactTag(tag);
// Set search criteria
searchCriteria.setTagOptions(tagOptions);
property.setSearchCriteria(searchCriteria);
// Change metadata value
property.setNewValue("GroupDocs-Cloud");
property.setType("string");
properties.add(property);
options.setProperties(properties);
// Apply metadata to EPUB
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("metadata/sample.epub");
options.setFileInfo(fileInfo);
SetRequest request = new SetRequest(options);
SetResult response = apiInstance.set(request);
view raw edit-epub-metadata.java hosted with ❤ by GitHub

結果の Epub ファイルをダウンロード

前の手順で指定したコードにより、結果のファイルがクラウドに保存されます。ダウンロードするには、次のコード スニペットを使用できます。

// api initialization
FileApi apiInstance = new FileApi(clientId, clientSecret);
// create download file request
DownloadFileRequest request = new DownloadFileRequest("metadata/sample_epub/sample.epub", "", null);
File response = apiInstance.downloadFile(request);
view raw download-file.java hosted with ❤ by GitHub

ボーナス: EPUB メタデータをオンラインで編集する

オンライン EPUB メタデータ エディタ
オンライン EPUB メタデータ エディター を使用してメタデータ管理エクスペリエンスを強化します。この使いやすい Web ベースのツールを使用すると、コードを 1 行も記述することなく、メタデータのプロパティを視覚的に変更できます。

＃＃＃ 特徴：

  • 直感的なユーザーインターフェイス
  • メタデータ変更のリアルタイム プレビュー
  • 複数の EPUB メタデータ プロパティのサポート
  • クロスプラットフォームの互換性 ＃＃＃ 使い方：
  1. ブラウザで GroupDocs.Metadata ツールを開きます。
  2. EPUB ファイルをアップロードまたはドラッグします。
  3. メタデータを確認して編集します。
  4. 更新された EPUB を保存してダウンロードします。

結論

このブログ投稿では、SDK のセットアップ、API クライアントの初期化、指定されたタグを使用したメタデータ プロパティの変更のプロセスについて説明しました。おまけとして、オンライン EPUB メタデータ エディターをボーナスとして導入し、手間のかからないメタデータ操作のためのユーザーフレンドリーなインターフェイスを提供しました。メタデータ管理の力を活用して、電子書籍コレクションを新たな高みに引き上げましょう。

Java ベースの GroupDocs.Metadata Cloud SDK は手順を簡素化し、カスタマイズのためのさまざまなオプションを提供します。自由に ドキュメント を調べ、さまざまな設定を試し、画像やドキュメントのメタデータを変更してブランド要件にシームレスに合わせてください。

さらに、専用の API リファレンス セクションがあり、Web ブラウザーを介して直接 API を視覚化したり、操作したりすることが容易になります。 Java SDK の広範なソース コードは Github でオープンに入手できます。

最終的に、私たちの取り組みは、独自のファイル形式と REST API を介したその解析を中心とした新鮮なブログ コンテンツの作成に重点を置き続けます。最新のアップデートを入手するには、常に接続してください。コーディングの取り組みが成功し、充実したものになることを祈っています。

質問する

EPUB メタデータ エディタに関するご質問や混乱がある場合は、フォーラム 経由でお気軽にお問い合わせください。

関連項目

役立つと思われる関連記事をいくつか紹介します。