ホンヨム サポート

目次

1. はじめに
2. 本を登録する方法
3. ISBNとは
4. 本の情報が見つからないとき
5. 表紙が表示されないとき
6. ホンヨムが本の情報を探す順番
7. Google Books APIとは
8. Google Books APIキーを作成する方法
9. APIキーを安全に使うための注意点
10. ホンヨムへAPIキーを設定する方法
11. バックアップと復元
12. よくある質問
13. お問い合わせ

1. はじめに

ホンヨムは、読書中、読了、積読、読みたい本を分けて管理するiPhoneアプリです。本棚の整理、読書記録、読み始め日や読了日の記録に使えます。

このページでは、ホンヨムの基本的な使い方と、Google Books APIキーの設定方法を説明します。APIキーは表紙画像を探すための追加手段です。APIキーがなくても、本棚管理や読書記録などの基本機能は利用できます。

2. 本を登録する方法

本を追加するときは、画面の「本を追加」を開きます。現在のアプリでは、次の方法で登録できます。

• 「本を検索」画面で「タイトルで検索」を選び、タイトルや著者名から探す
• 「本を検索」画面で「ISBNで検索」を選び、ISBNを入力して探す
• 「バーコードを読み取る」から、ISBNバーコードをカメラで読み取る
• 「本を追加」画面でタイトル、著者、ページ数、読書状態などを手入力する

登録後は、タイトル、著者、総ページ数、読書状態、ISBN、出版社、出版日、読了日、表紙、メモを編集できます。表紙は、写真から選ぶ、カメラで撮影する、表紙画像を外す、表紙の色を変える操作に対応しています。

3. ISBNとは

ISBNは、書籍を識別するための番号です。多くの本では、裏表紙や奥付に記載されています。

• 10桁または13桁の場合があります。
• 紙の本ではバーコードの近くに書かれていることがあります。
• 電子書籍、古い本、自費出版の本などではISBNがない場合があります。

ISBNが分からない場合は、「タイトルで検索」を使ってください。

4. 本の情報が見つからないとき

タイトル、著者、出版社などの本の情報が見つからない場合、次のような理由が考えられます。

• ISBNや検索語が正しくない
• 書籍データの提供元に書誌情報がない
• 古い本、電子書籍、自費出版の本などで情報が少ない
• 通信できない状態になっている

Google Books APIキーの未設定は、ホンヨムでタイトルや著者などの書誌情報が見つからない直接の原因ではありません。Google Books APIキーは、表紙画像を探す追加手段として使われます。

5. 表紙が表示されないとき

表紙が表示されない場合、次のような理由が考えられます。

• 書籍データの提供元に表紙画像がない
• ISBNが誤っている、または別の版のISBNになっている
• 通信できない状態になっている
• Google Books APIキーが未設定で、追加の表紙検索を使っていない

APIキーを設定しても、すべての本の表紙が必ず表示されるわけではありません。必要に応じて、ホンヨム内で写真から表紙を設定できます。

Google Booksやほかの情報提供元で、あとから表紙が利用できるようになる場合があります。数時間後や数日後に、本の詳細画面の「本情報を再取得」を押して確認してください。ISBNや登録内容が正しいかもあわせて確認してください。再取得しても、すべての本に表紙が表示されるわけではありません。

手動で設定した表紙画像は、編集画面から外すこともできます。

6. ホンヨムが本の情報を探す順番

ISBN検索では、まず端末内のキャッシュを確認し、その後にopenBD、国立国会図書館の検索サービスを使って書誌情報を探します。表紙はOpen Library、設定されている場合はGoogle Books APIも追加で使います。

タイトル検索では、国立国会図書館の検索サービスを中心に探します。ISBNが分かる場合はopenBDの情報で補えることがあります。Google Books APIから取得しているのは表紙画像の候補です。

7. Google Books APIとは

Google Books APIは、Googleが提供する書籍検索用のAPIです。APIとは、アプリが外部サービスへ問い合わせるための仕組みです。

ホンヨムでは、Google Books APIを表紙画像を探す追加取得先として使います。タイトル、著者、出版社、ページ数などの書誌情報はGoogle Books APIから取得していません。

• Google Books APIキーなしでも、本棚管理、読書記録、本の検索・登録などの基本機能は使えます。
• APIキーを設定すると、openBDやOpen Libraryで表紙が見つからない一部の本について、Google Booksからも表紙画像を探します。
• sakumori.comがAPIキーを発行するわけではありません。
• 利用者自身のGoogleアカウントでGoogle CloudからAPIキーを作成します。
• APIキーはホンヨムへ入力します。
• APIキーをsakumori.comへ送信する仕組みではありません。

8. Google Books APIキーを作成する方法

Google Cloudの画面名や配置は変更される場合があります。分からない場合は、Google Cloud内の検索欄で「Books API」や「認証情報」を探してください。

うまくいかない場合は、次を確認してください。

9. APIキーを安全に使うための注意点

• 他人に送らないでください。
• SNSやブログに掲載しないでください。
• GitHubなどの公開場所へ書かないでください。
• Books APIだけに使えるよう、API制限を設定してください。
• 不要になったキーはGoogle Cloudで削除できます。
• 漏えいした可能性がある場合は、古いキーを削除して作り直してください。

ホンヨムに保存したAPIキーはiPhoneのKeychainに保存されます。Google Books APIへ問い合わせるときは、APIキーがGoogleへ送信されます。sakumori.comや運営者のサーバーへAPIキーを送信する仕組みは確認されていません。

APIキーはJSONバックアップには含まれません。機種変更後も使う場合は、新しい端末で再設定してください。

10. ホンヨムへAPIキーを設定する方法

ホンヨムの設定画面で「表紙取得」セクションを開きます。「Google Books APIキー」に作成したキーを入力し、「APIキーを保存」を押してください。

保存後は、次に表紙画像を探すときから使われます。「APIキーをテスト」を押すと、Google Books APIへ接続できるか確認できます。成功時は「Google Books APIへ接続できました。」と表示されます。失敗時は「Google Books APIへ接続できませんでした。キーやAPI設定を確認してください。」と表示されます。

「APIキーを削除」を押すと、保存済みのキーを削除できます。入力欄を空にして保存した場合も、保存済みのキーは削除されます。

ホンヨム内で削除しても、Google Cloud側のAPIキーは残ります。不要になったキーはGoogle Cloud側でも削除してください。

11. バックアップと復元

ホンヨムはJSONバックアップと復元に対応しています。バックアップとは、本棚データをJSONファイルとして書き出し、端末の外にも保管できるようにする機能です。

バックアップには、本の情報と読書記録が含まれます。

• 本のタイトル、著者、ページ数、読書状態、ISBN、出版社、出版日、読み始め日、読了日、メモ、書影URLなど
• 読書記録の開始日、終了日、ページ数、メモなど

手動で設定した表紙画像の実データ、画像キャッシュ、Google Books APIキー、表示設定はバックアップに含まれません。iCloud同期、CloudKit同期、自動バックアップを前提とした説明は行いません。

復元すると現在の本棚データはバックアップファイルの内容に置き換わります。マージではありません。必要なデータがある場合は、先に現在のバックアップを作成してください。

機種変更時は、古い端末でJSONバックアップを作成し、そのファイルを新しい端末へ移して復元してください。Google Books APIキーを使う場合は、新しい端末で再設定してください。

13. お問い合わせ

ホンヨムの使い方や不具合については、Contact からお問い合わせください。問い合わせ時は、アプリ名、利用端末、iOSバージョン、発生した操作、表示されたメッセージを書いてください。