このページは Cloud Translation API によって翻訳されました。

Dynamic Links

Google ブックスのダイナミックリンク機能を使用すると、サイトから Google ブックスへのカスタマイズが可能な信頼性の高いリンクを作成できます。たとえば、Google のインデックスに登録された書籍のみが表示されるリンクや、Google ブックスで書籍をプレビューできるかどうかをユーザーに示すリンクを表示する場合に、このツールが使用できます。Dynamic Links 機能を使用すると、Google ブックスへのリンクにサムネイル画像を追加できます。このドキュメントでは、サイトにこの機能をすばやく追加する方法について説明します。

注: この機能は、以前は Book Viewability API と呼ばれていました。

プレビューウィザードは、ダイナミックリンクの上に構築されたツールで、コードを数行コピーするだけで、サイトからプレビューへ簡単にリンクできます。このドキュメントは、書籍検索とのリンク方法をカスタマイズしようとしている上級デベロッパーを対象としています。

視聴者

ダイナミックリンクに関するドキュメントは、Google ブックス内の書籍にリンクするウェブアプリケーションを作成するプログラマーを対象としています。このドキュメントは、HTTP プロトコルと基本的な JavaScript に精通していることを前提としています。

書籍検索の用語

Google ブックスではユーザーの地域による著作権の制限が優先されるため、一部の書籍のプレビューや全体表示は、一部の地域ではご利用いただけません。視認性は、次のクラスにクラスタ化されています。

全体表示: 書籍全体が表示対象となります。これらの書籍はパブリックドメインである場合があります。
限定的な使用: 書籍の一部を閲覧できる。この書籍は著作権で保護されているため、Google ブックスはこうしたページへのアクセスをユーザーに許可しています。これらの書籍は、ユーザーがページ全体を閲覧できるという点でスニペット表示の書籍とは異なります。
スニペットを表示、プレビューなし: ユーザーには、[書籍について] ページのみが表示されます。書籍から抜粋できるのは、最大でも一部のみです。この書籍はスキャンされていないか、著作権で保護されているため、ユーザーの検索キーワードに関連する複数のスニペットを公開するための許可が Google ブックスに与えられていません。

はじめに

静的リンクのドキュメントでは、Google ブックスの特定の書籍のページへの URL を生成する非常に簡単な方法について説明しています。残念ながら、特定の書籍が Google ブックスのインデックスに登録されていない、または特定の地域のユーザーがプレビューを利用できない場合があります。静的リンクは「ブラインド」であるため、意図した効果が得られないことがあります。

Dynamic Links は、JavaScript を使用して書籍の視認性をクエリする、プログラマティックなクライアント側の代替方法を提供します。これにより、書籍検索への信頼性の高いリンクと予測可能なリンクを含めることができ、ユーザーエクスペリエンスの一貫性が向上します。視認性はエンドユーザーの場所によって異なるため、ダイナミックリンクインターフェースはサーバーサイドまたはオフラインのクエリ用には設計されていません。

Dynamic Links で何ができるかについては、このドキュメントの最後にあるコードサンプルに進んでください。

ブランドの取り扱いガイドライン

Dynamic Links をレンダリングする場合、Google Books API ファミリーのブランディングガイドラインを遵守する必要があります。特に、

帰属表示と Google ブックスへのリンクを維持する必要があります。
Google ブックスでプレビューにリンクする際は、承認済みの Google プレビューボタンのみを使用する必要があります。
テキストリンク、ボタン、ドキュメント、説明テキストはすべて、承認済みの命名規則を遵守する必要があります。たとえば、Google ブックスでのプレビューにリンクするときは、「ダウンロード」や「読み取り」などの動詞を使用しないでください。ダウンロードできるのは、パブリックドメインの作品のみです。

ブランディングの例

Freakonomics: An Rogue Economist Explores the Hidden Side of Everything

作者: Steven Levitt and Stephen Dubner

このドキュメントの最後にあるサンプルセクションには、現在のブランディングガイドラインを遵守したその他の例が記載されています。

クライアントサイド API

クライアント側のダイナミックリンクの中核となるのは、デベロッパーが 1 冊以上の書籍に関する情報をリクエストする URL を作成し、そのタグを <script> タグを使って Google ブックスに送信できる URL 形式です。

構文の例:: <script src="https://books.google.com/books?bibkeys=ISBN:0451526538&jscmd=viewapi&callback=mycallback"></script>

リクエストの形式

URL の形式は、書籍にリンクするために使用する URL 構文に似ていますが、書籍 ID フィールドには複数の書籍 ID をカンマで区切って指定できます。また、' jscmd' と 'callback' パラメータもあります。任意で、視認性フィルタを制御するための追加引数を指定することもできます。

Dynamic Links は、書籍を識別するためのさまざまな方法（ISBN、OCLC 番号、LCCN キー）をサポートしています。API により、GET リクエストの最大サイズまでのバッチクエリが可能になります。

ISBN: &bibkeys=ISBN:0451526538（API は ISBN 10 と 13 の両方に対応しています）。
OCLC: &bibkeys=OCLC:36792831
LCCN（LCCN）: &bibkeys=LCCN:96072233

JSON 結果の形式

この呼び出しからのレスポンスは、1 つ以上の JSON オブジェクトとして返される、リクエストされた書籍に関する情報になります。JSON オブジェクトの構造は次のとおりです。

JsonSearchResult {
    string bib_key;
    string info_url;
    string preview_url;
    string thumbnail_url;
    string preview;
};

これらのフィールドには、次の情報が表示されます。

bib_key: この書籍に対してクエリを実行するために使用される識別子。
情報 URL: 書籍に関する情報（この書籍のページ）がある Google ブックス内のページの URL。
プレビュー URL: 書籍のプレビューの URL。ユーザーを書籍の表紙に直接誘導します。リクエスト可能なスニペットビューまたはプレビュー不可の書籍のみの場合、プレビュー URL は返されません。
サムネイル URL: 書籍の表紙のサムネイルへの URL。
プレビュー: 書籍の視認性の状態を示す値。full（全文表示の場合）、partial（限定プレビューの書籍）、noview（スニペットまたはプレビューなし）を指します。
埋め込み可能: 書籍検索の埋め込みビューアを使用してサードパーティのページに書籍を埋め込むことができる場合、このブール値は true です。

Dynamic Links

目次

視聴者

書籍検索の用語

はじめに

ブランドの取り扱いガイドライン

ブランディングの例

クライアントサイド API

リクエストの形式

JSON 結果の形式

パラメータとその他のフィールド

同期モードと非同期モード

非同期モード

同期モード

よくある質問

コードサンプル